LoadXmlAsync Method (DicomUidTable)

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

public IAsyncAction LoadXmlAsync( 
   ILeadStream stream
)

'Declaration

Public Function LoadXmlAsync( _
   ByVal stream As ILeadStream _
) As IAsyncAction

'Usage

Dim instance As DicomUidTable
Dim stream As ILeadStream
Dim value As IAsyncAction
 
value = instance.LoadXmlAsync(stream)

public IAsyncAction LoadXmlAsync( 
   ILeadStream stream
)

 function Leadtools.Dicom.DicomUidTable.LoadXmlAsync( 
   stream 
)

public:
IAsyncAction^ LoadXmlAsync( 
   ILeadStream^ stream
)

Parameters

stream: A stream that contains the XML data containing the DICOM UIDs to load

Return Value

An asynchronous load operation on a DicomTagTable object.

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

For more information, see the topic Working with DICOM Tables

This example loads the DICOM UID table from the dicTableUid.xml file that is shipped with the toolkit.

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Dicom

<TestMethod()> _
Public Sub TestDicomUidTable_LoadXml_Stream()
   DicomEngine.Startup()
   'Remove all entries from the table
   DicomUidTable.Instance.Reset()

   ' Since the table is empty, the count is zero.
   Dim count As Integer = DicomUidTable.Instance.GetCount()

   ' Load the UID table from the dicTableUid.xml file that ships with the toolkit
   Using stream As New FileStream("C:\Users\Public\Documents\LEADTOOLS Images\dicTableUid.xml", FileMode.Open)
      DicomUidTable.Instance.LoadXml(stream)

      ' Get the count -- it will be 295
      count = DicomUidTable.Instance.GetCount()
   End Using
   DicomEngine.Shutdown()
End Sub

using Leadtools;
using Leadtools.Dicom;

[TestMethod]
public void TestDicomUidTable_LoadXml_Stream()
{
   DicomEngine.Startup();
   //Remove all entries from the table
   DicomUidTable.Instance.Reset();

   // Since the table is empty, the count is zero.
   int count = DicomUidTable.Instance.GetCount();

   // Load the UID table from the dicTableUid.xml file that ships with the toolkit
   using (FileStream stream = new FileStream(@"C:\Users\Public\Documents\LEADTOOLS Images\dicTableUid.xml", FileMode.Open))
   {
      DicomUidTable.Instance.LoadXml(stream);

      // Get the count -- it will be 295
      count = DicomUidTable.Instance.GetCount();
   }
   DicomEngine.Shutdown();
}

using Leadtools;
using Leadtools.Dicom;
using Leadtools.Examples;

public void TestDicomUidTable_LoadXml_Stream(FileStream stream)
{
   DicomEngine.Startup();
   //Remove all entries from the table
   DicomUidTable.Instance.Reset();

   // Since the table is empty, the count is zero.
   int count = DicomUidTable.Instance.GetCount();

   // Load the UID table from  a stream that contains the contents of the dicTableUid.xml file that ships with the toolkit
   DicomUidTable.Instance.LoadXml(stream);

   // Get the count -- it will be 295
   count = DicomUidTable.Instance.GetCount();
   DicomEngine.Shutdown();
}

Imports Leadtools
Imports Leadtools.Dicom

Public Sub TestDicomUidTable_LoadXml_Stream(ByVal stream As FileStream)
  DicomEngine.Startup()
  'Remove all entries from the table
  DicomUidTable.Instance.Reset()

  ' Since the table is empty, the count is zero.
  Dim count As Integer = DicomUidTable.Instance.GetCount()

  ' Load the UID table from  a stream that contains the contents of the dicTableUid.xml file that ships with the toolkit
  DicomUidTable.Instance.LoadXml(stream)

  ' Get the count -- it will be 295
  count = DicomUidTable.Instance.GetCount()
  DicomEngine.Shutdown()
End Sub

Target Platforms

Reference

DicomUidTable Class
DicomUidTable Members
Insert Method
Delete Method
Reset Method
Default Method