LoadXml(Stream) Method

Summary

Loads the context groups contained in stream into the internal DICOM context group table

Syntax

C++

public void LoadXml( 
   Stream stream 
)

Public Overloads Sub LoadXml( _ 
   ByVal stream As Stream _ 
)

public: 
void LoadXml(  
   Stream^ stream 
)

Parameters

stream
A Stream that contains the XML data containing the context groups to load.

Remarks

Quickly and easily customize the DICOM Context Group Table by editing the dicTableContextGroup.xml file that is found in the LEADTOOLS Sample Images folder. The dicTableContextGroup.xml file is a human-readable XML file that lists all of the DICOM context groups currently defined in the DICOM Specification. You can edit this with any text editor (i.e. notepad) to add or remove DICOM context groups. Then call LoadXml and pass the full path of the dicTableContextGroup.xml file, or pass a Stream containing the contents of this file. Note that calling LoadXml will first remove all context groups that are already present in the table.

For more information, see the topic Working with DICOM Tables

Example

This example loads the DICOM Context Group table from the dicTableContextGroup.xml file that is shipped with the toolkit.

using Leadtools; 
using Leadtools.Dicom; 
 
public void TestDicomContextGroupTable_LoadXml_Stream() 
{ 
   DicomEngine.Startup(); 
 
   DicomContextGroupTable.Instance.Reset(); 
 
   // Since the table is empty, the count is zero. 
   int count = 0; 
   DicomContextGroup contextGroup = DicomContextGroupTable.Instance.GetFirst(); 
   while (contextGroup != null) 
   { 
      contextGroup = DicomContextGroupTable.Instance.GetNext(contextGroup); 
      count++; 
   } 
 
   // Load the IOD table from the dicTableContextGroup.xml file that ships with the toolkit 
   using (FileStream stream = File.OpenRead(@"C:\Users\Public\Documents\LEADTOOLS Images\dicTableContextGroup.xml")) 
   { 
      DicomContextGroupTable.Instance.LoadXml(stream); 
   } 
 
   // Get the count -- it will be 197 
   contextGroup = DicomContextGroupTable.Instance.GetFirst(); 
   while (contextGroup != null) 
   { 
      contextGroup = DicomContextGroupTable.Instance.GetNext(contextGroup); 
      count++; 
   } 
 
   DicomEngine.Shutdown(); 
}

Imports Leadtools 
Imports Leadtools.Dicom 
 
Public Sub TestDicomContextGroupTable_LoadXml_Stream() 
   DicomEngine.Startup() 
 
   DicomContextGroupTable.Instance.Reset() 
 
   ' Since the table is empty, the count is zero. 
   Dim count As Integer = 0 
   Dim contextGroup As DicomContextGroup = DicomContextGroupTable.Instance.GetFirst() 
   Do While contextGroup IsNot Nothing 
      contextGroup = DicomContextGroupTable.Instance.GetNext(contextGroup) 
      count += 1 
   Loop 
 
   ' Load the IOD table from the dicTableContextGroup.xml file that ships with the toolkit 
   Using stream As Stream = File.OpenRead("C:\Users\Public\Documents\LEADTOOLS Images\dicTableContextGroup.xml") 
      DicomContextGroupTable.Instance.LoadXml(stream) 
   End Using 
 
   ' Get the count -- it will be 197 
   contextGroup = DicomContextGroupTable.Instance.GetFirst() 
   Do While contextGroup IsNot Nothing 
      contextGroup = DicomContextGroupTable.Instance.GetNext(contextGroup) 
      count += 1 
   Loop 
 
   DicomEngine.Shutdown() 
End Sub