LoadAsync(String,DicomDataSetLoadFlags) Method

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

public IAsyncOperation<bool> LoadAsync( 
   string path,
   DicomDataSetLoadFlags flags
)

'Declaration
 
Public Overloads Function LoadAsync( _
   ByVal path As String, _
   ByVal flags As DicomDataSetLoadFlags _
) As IAsyncOperation(Of Boolean)

'Usage
 
Dim instance As DicomDataSet
Dim path As String
Dim flags As DicomDataSetLoadFlags
Dim value As IAsyncOperation(Of Boolean)
 
value = instance.LoadAsync(path, flags)

public IAsyncOperation<bool> LoadAsync( 
   string path,
   DicomDataSetLoadFlags flags
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomDataSet.LoadAsync(String,DicomDataSetLoadFlags)( 
   path ,
   flags 
)

public:
IAsyncOperation<bool>^ LoadAsync( 
   String^ path,
   DicomDataSetLoadFlags flags
)

Parameters

path: The name of the file that contains the Data Set to be loaded.
flags: Meta-header flags and Transfer Syntax flags that indicate the file characteristics to use when loading the file.

Return Value

When this method completes, it returns the true if the dataset was loaded, false otherwise.

If you know certain characteristics of the file, you can set those in flags. Any characteristic that you do not set will be automatically determined. For example, if you know that the Meta-header is present, but you do not know the byte order, or whether the Value Representation is Implicit or Explicit, you can set only DicomDataSetLoadFlags.MetaHeaderPresent in flags. During loading, LEADTOOLS will determine the byte order and whether the byte order is Implicit or Explicit.

If you do not know any of the characteristics of the file, set flags to DicomDataSetLoadFlags.None and LEADTOOLS will automatically determine all the file characteristics and load the file accordingly.

If DicomDataSetLoadFlags.LoadAndClose is not included in flags, the file will remain open until the object is destructed, or one of the following methods is called: Reset, Initialize(DicomClassType,DicomDataSetInitializeType), or Load(String,DicomDataSetLoadFlags) (again). If LoadAndClose is used, for large images, this mage slow performance, however, the file handle will be released. If set to None, large images will load quickly, and image travers can begin immediately. However, until the file handle is released, nothing can be done to the image.

To load a Data Set from memory, call Load(IntPtr,Int64,DicomDataSetFlags).

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

Copy Code

[TestMethod]
public async Task LoadEnumerateSample()
{
   //Make sure to initialize the DICOM engine, this needs to be done only once 
   //In the whole application
   DicomEngine.Startup();
   using (DicomDataSet ds = new DicomDataSet())
   {
      //Load DICOM File
      string dicomFilePath = @"Assets\IMAGE3.dcm";
      StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(dicomFilePath);
      bool success = await ds.LoadAsync(LeadStreamFactory.Create(loadFile),DicomDataSetLoadFlags.None);
      Debug.Assert(success);
      //Insert patient name element, if it doesn't already exist
      DicomElement element = ds.FindFirstElement(null, DicomTagConstants.PatientName, false);
      if (element == null)
      {
         element = ds.InsertElement(null, false, DicomTagConstants.PatientName, DicomVRType.PN, false, 0);
      }
      //The dataset should include the patient name element or an error occurred
      element = ds.FindLastElement(null, DicomTagConstants.PatientName, false);
      Debug.Assert(element != null);
      //There can be only one patient element in the root level
      element = ds.FindPreviousElement(null, false);
      Debug.Assert(element == null);
      element = ds.FindNextElement(null, false);
      Debug.Assert(element == null);

      element = ds.FindFirstElement(null, DicomTagConstants.PatientName, false);
      //Since the patient name element is in the root level,
      //GetRootElement will return the same element.
      DicomElement element1 = ds.GetRootElement(element);
      Debug.Assert((element1.Tag == element.Tag), "GetRootElement should return same element");

      //Since the patient name element has no parent then GetParentElement will return null
      element1 = ds.GetParentElement(element);
      Debug.Assert(element1 == null, "GetParentElement should return null");

      //Since the patient name element has no children then GetChildElement will return null
      element1 = ds.GetChildElement(element, false);
      Debug.Assert(element1 == null, "GetChildElement should return null");

      element1 = ds.GetFirstElement(element, false, false);
      Debug.Assert(element1 != null, "GetFirstElement Can't return null in this case");

      element1 = ds.GetLastElement(element, false, false);
      Debug.Assert(element1 != null, "GetLastElement Can't return null in this case");

      element1 = ds.GetPreviousElement(element, false, true);
      DicomElement element2 = ds.GetNextElement(element, false, true);

      Debug.Assert(ds.GetElementLevel(element) == 0);

      Debug.Assert(ds.ExistsElement(element));
      Debug.Assert(ds.IsVolatileElement(element) == false);

      //Patient Name is not the only element in this level
      Debug.Assert((element1 != null) && (element2 != null));
      //Delete the patient name element
      ds.DeleteElement(element);
   }
   DicomEngine.Shutdown();
}

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

DicomDataSet Class
DicomDataSet Members
Overload List
Load(IntPtr,Int64,DicomDataSetFlags) Method
Save(String,DicomDataSetSaveFlags) Method