Insert Method

Summary

Inserts a new item in the UID Table.

Syntax

Objective-C

C++/CLI

Java

public DicomUid Insert( 
   string code, 
   string name, 
   DicomUIDCategory type 
)

- (nullable LTDicomUid *)insert:(NSString *)code name:(NSString *)name type:(LTDicomUIDCategory)type NS_SWIFT_NAME(insert(code:name:type:));

public DicomUid insert(String code, String name, DicomUidCategory type)

public: 
DicomUid^ Insert(  
   String^ code, 
   String^ name, 
   DicomUIDCategory type 
)

Parameters

code
Unique identifier code.

name
The name of the unique identifier.

type
Type of UID to insert.

Return Value

The newly inserted item.

Remarks

Inserted UID items will work within LEADTOOLS, however, in order for new UID values to work across countries, sites, equipment, etc. you must contact the National Electrical Manufacturers Association.
All items are inserted at the bottom of the table.
For more information on the DICOM file format, refer to An Overview of the DICOM File Format or the DICOM Standard.

Example

using Leadtools; 
using Leadtools.Dicom; 
 
 
public void TestUIDTable() 
{ 
 
   //Make sure to initialize the DICOM engine, this needs to be done only once  
   //In the whole application 
   DicomEngine.Startup(); 
 
   //We don't need to call this since the DicomEngine.Startup already does that for us 
   //These calls are for demonstration purposes only 
   DicomUidTable.Instance.Reset(); 
   DicomUidTable.Instance.Default(); 
 
   //We can also call FindByIndex if we know the index of this UID 
   DicomUid uid = DicomUidTable.Instance.Find(DicomUidType.SCImageStorage); 
   DicomUidTable.Instance.Delete(uid); 
 
   DicomUid uid1 = DicomUidTable.Instance.Insert(DicomUidType.SCImageStorage, "Secondary Capture Image Storage", DicomUIDCategory.Class); 
   Debug.Assert(DicomUidTable.Instance.Exists(uid1) == true); 
   DicomUidTable.Instance.SetName(uid1, "Secondary Capture Image Storage 1"); 
 
   int count = 0; 
   //If we want to loop through all the UIDs in the table we can do this: 
   uid = DicomUidTable.Instance.GetFirst(); 
   while (uid != null) 
   { 
      // We can also access the rest of the properties of DicomUid in here, 
      // such as DicomUid.Code, DicomUid.Name, DicomUid.Type 
 
      if (uid.Code == DicomUidType.SCImageStorage) 
      { 
         Console.WriteLine(uid.Name); 
      } 
      count++; 
      uid = DicomUidTable.Instance.GetNext(uid); 
   } 
   //We can use GetLast and GetPrevious to achieve the same thing 
 
   Debug.Assert(count == DicomUidTable.Instance.GetCount()); 
 
   DicomEngine.Shutdown(); 
}

Requirements

Target Platforms

Reference

DicomUidTable Class

DicomUidTable Members

Delete Method

Reset Method

Default Method

Download our FREE evaluation

Help Version 22.0.2023.1.29

Leadtools.Dicom Assembly

Introduction

Getting Started

Namespaces

Leadtools.Dicom Namespace

Assemblies