In This Topic ▼

LoadXml(DicomDataSet,string,DicomDataSetLoadXmlFlags,LoadXmlBeforeElementCallback,LoadXmlAfterElementCallback) Method

Summary

Loads the contents of a DICOM encoded XML file.

Syntax

C++/CLI

public static void LoadXml( 
   this DicomDataSet ds, 
   string fileName, 
   DicomDataSetLoadXmlFlags xmlFlags, 
   LoadXmlBeforeElementCallback cbBefore, 
   LoadXmlAfterElementCallback cbAfter 
)

[ExtensionAttribute()] 
public: 
static void LoadXml(  
   DicomDataSet^ ds, 
   String^ fileName, 
   DicomDataSetLoadXmlFlags xmlFlags, 
   LoadXmlBeforeElementCallback^ cbBefore, 
   LoadXmlAfterElementCallback^ cbAfter 
)

Parameters

ds
The Data Set that will be created and populated with the contents of the DICOM XML input file

fileName
The name of the input XML file

xmlFlags
Flags that affect whether to ignore binary or all data from the DICOM XML input file

cbBefore
Optional callback that allows you to modify how the input XML file elements, attributes, and values are used.

cbAfter
Optional callback that allows you to change the DicomElement after it has been added to the DicomDataSet.

Remarks

Use this method to read the contents of a DICOM XML file. The DICOM XML file can be created using SaveXml By default, all binary data is read from the DICOM input XML file, but this behavior can be modified by passing appropriate DicomDataSetLoadXmlFlags

The way that this method processes the input XML file elements, attributes, and element values can be customized by passing the optional LoadXmlBeforeElementCallback delegate. For more information on this, see the documentation and example for LoadXmlBeforeElementCallback. The DicomElement themselves can be modified after they have been added to the DicomDataSet by passing the optional LoadXmlAfterElementCallback delegate. For more information on this, see the documentation and example for LoadXmlAfterElementCallback.

Example

This example will load a sample DICOM data set, then save it as an XML file (with no binary data), and then reload the XML file into a DicomDataSet object

using Leadtools.Dicom; 
using Leadtools.Dicom.Common; 
using Leadtools.Dicom.Common.Extensions; 
using Leadtools; 
using Leadtools.Dicom.Common.Linq.BasicDirectory; 
using Leadtools.Dicom.Common.DataTypes; 
 
using Leadtools.Codecs; 
 
public void LoadXmlExample() 
{ 
   string dicomFileNameIn = Path.Combine(LEAD_VARS.ImagesDir, "DICOM", "image3.dcm"); 
   string xmlFileNameOut = Path.Combine(LEAD_VARS.ImagesDir, "test.xml"); 
 
   // Initialize DICOM engine 
   DicomEngine.Startup(); 
 
   DicomDataSet ds = new DicomDataSet(); 
 
   // Load an existing DICOM file 
   ds.Load(dicomFileNameIn, DicomDataSetLoadFlags.None); 
 
   // Save as XML with no binary data 
   // For the demo, keep the XML output file size small by skipping the pixel data 
   DicomDataSetSaveXmlFlags xmlFlags = 
      DicomDataSetSaveXmlFlags.IgnoreBinaryData | 
      DicomDataSetSaveXmlFlags.TrimWhiteSpace | 
      DicomDataSetSaveXmlFlags.TagWithCommas; 
   ds.SaveXml(xmlFileNameOut, xmlFlags); 
 
   // Now reload the XML file.   
   // Note that there will not be an image because we skipped the pixel data in the save 
   ds.LoadXml(xmlFileNameOut, DicomDataSetLoadXmlFlags.None); 
 
   DicomEngine.Shutdown(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}