LoadXmlAsync Method (DicomTagTable)

Visual Basic
C#
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 DicomTagTable
Dim stream As ILeadStream
Dim value As IAsyncAction
 
value = instance.LoadXmlAsync(stream)

public IAsyncAction LoadXmlAsync( 
   ILeadStream stream
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomTagTable.LoadXmlAsync( 
   stream 
)

public:
IAsyncAction^ LoadXmlAsync( 
   ILeadStream^ stream
)

Parameters

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

Return Value

An asynchronous load operation on a DicomTagTable object.

Beginning with version 17.5 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(String) and pass the full path of the dicTableElement.xml file, or pass a System.IO.Stream containing the contents of this file. Note that calling LoadXmlAsync will first remove all DICOM elements that are already present in the table.

For more information, see the Working with DICOM Tablestopic .

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

Copy Code

Public Sub TestDicomTagTable_LoadXml_Stream()
         DicomEngine.Startup()

         DicomTagTable.Instance.Reset()

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

         Using stream As New FileStream("C:\Users\Public\Documents\LEADTOOLS Images\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()
         End Using
         DicomEngine.Shutdown()
     End Sub

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:\Users\Public\Documents\LEADTOOLS Images\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();
}

public void TestDicomTagTable_LoadXml_Stream(FileStream stream)
{
   DicomEngine.Startup();
   DicomTagTable.Instance.Reset();

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

   // Load the DICOM Element Tag table from a stream that contains the contents of 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();
}

Public Sub TestDicomTagTable_LoadXml_Stream(ByVal stream As FileStream)
  DicomEngine.Startup()
  DicomTagTable.Instance.Reset()

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

  ' Load the DICOM Element Tag table from a stream that contains the contents of 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()
End Sub

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DicomTagTable Class
DicomTagTable Members
Delete Method
Reset Method
Default Method
Insert Method