LoadXml(Stream) Method

Summary

Loads the Element Tags contained in stream into the internal DICOM Element Tag Table.

Syntax

Objective-C

C++/CLI

public void LoadXml( 
   Stream stream 
)

- (BOOL)loadXmlData:(NSData *)data error:(NSError **)error NS_SWIFT_NAME(loadXml(_:));

public: 
void LoadXml(  
   Stream^ stream 
)

Parameters

stream
A stream that contains the XML data for the DICOM element tags to load.

Remarks

Beginning with version 18 of the toolkit, you can easily and quickly customize the DICOM Element Tag table by editing the dicTableElement.xml file that is found in the LEADTOOLS Sample Images folder. The dicTableElement.xml file is a human-readable XML file that lists all of the DICOM Element Tags currently defined in the DICOM Specification. You can edit this with any text editor (for example, notepad) to add or remove DICOM Elements. Then call LoadXml and pass the full path of the dicTableElement.xml file, or pass a Stream containing the contents of this file. Note that calling LoadXml will first remove all DICOM elements that are already present in the table. For more information, see the Working with DICOM Tablestopic .

Example

This example loads the DICOM Element Tag table from the dicTableElement.xml file that is shipped with the toolkit.

using Leadtools; 
using Leadtools.Dicom; 
 
 
public void TestDicomTagTable_LoadXml_Stream() 
{ 
   DicomEngine.Startup(); 
 
   DicomTagTable.Instance.Reset(); 
 
   // Since the table is empty, the count is zero. 
   int count = DicomTagTable.Instance.GetCount(); 
 
   using (FileStream stream = new FileStream(@"C:\LEADTOOLS23\Resources\Images\DICOM\dicTableElement.xml", FileMode.Open)) 
   { 
      // Load the DICOM Element Tag table from the dicTableTag.xml file that ships with the toolkit 
      DicomTagTable.Instance.LoadXml(stream); 
 
      // Get the count -- it will be around 3000 
      count = DicomTagTable.Instance.GetCount(); 
   } 
   DicomEngine.Shutdown(); 
}