Load(Stream,DicomDataSetLoadFlags) Method

Summary

Loads a Data Set from a stream.

Syntax

C++

Java

public virtual void Load( 
   Stream stream, 
   DicomDataSetLoadFlags flags 
)

Public Overloads Overridable Sub Load( _ 
   ByVal stream As Stream, _ 
   ByVal flags As DicomDataSetLoadFlags _ 
)

public void load(ILeadStream stream, /*DicomDataSetLoadFlags*/ int flags)

public: 
virtual void Load(  
   Stream^ stream, 
   DicomDataSetLoadFlags flags 
)

Parameters

stream
A stream 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.

Remarks

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.

In this overload, the DicomDataSetLoadFlags.LoadAndClose is always used internally, even if not included in the flags

To load a Data Set from memory, you can also use DicomDataSet.Load(IntPtr, long, DicomDataSetFlags). To load a Data Set from a file, you can use DicomDataSet.Load(string, DicomDataSetLoadFlags).

Example

This example will load a DICOM Dataset from a file, save to a stream, load from a stream, and save to another file.

using Leadtools; 
using Leadtools.Dicom; 
 
public void LoadFromStreamSample() 
{ 
   string dicomFileNameInput = Path.Combine(LEAD_VARS.ImagesDir, "IMAGE3.dcm"); 
   string dicomFileNameOutput = Path.Combine(LEAD_VARS.ImagesDir, "Image3_copy.dcm"); 
   DicomEngine.Startup(); 
 
   using (DicomDataSet ds = new DicomDataSet()) 
   { 
      using (FileStream streamInput = new FileStream(dicomFileNameInput, FileMode.Open)) 
      { 
         // Load a DICOM data set from a stream 
         ds.Load(streamInput, DicomDataSetLoadFlags.None); 
 
         // Save to another output stream 
         using (FileStream streamOutput = new FileStream(dicomFileNameOutput, FileMode.Create)) 
         { 
            ds.Save(streamOutput, DicomDataSetSaveFlags.None); 
         } 
 
      } 
   } 
   DicomEngine.Shutdown(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools 
Imports Leadtools.Dicom 
 
Public Sub LoadFromStreamSample() 
   Dim dicomFileNameInput As String = Path.Combine(LEAD_VARS.ImagesDir, "IMAGE3.dcm") 
   Dim dicomFileNameOutput As String = Path.Combine(LEAD_VARS.ImagesDir, "Image3_copy.dcm") 
   DicomEngine.Startup() 
 
   Using ds As New DicomDataSet() 
      Using streamInput As New FileStream(dicomFileNameInput, FileMode.Open) 
         ' Load a DICOM data set from a stream 
         ds.Load(streamInput, DicomDataSetLoadFlags.None) 
 
         ' Save to another output stream 
         Using streamOutput As New FileStream(dicomFileNameOutput, FileMode.Create) 
            ds.Save(streamOutput, DicomDataSetSaveFlags.None) 
         End Using 
 
      End Using 
   End Using 
   DicomEngine.Shutdown() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

Requirements

Target Platforms

Reference

DicomDataSet Class

DicomDataSet Members

Overload List

Load(IntPtr,Int64,DicomDataSetFlags) Method

Save(String,DicomDataSetSaveFlags) Method

Download our FREE evaluation

Help Version 20.0.2020.3.31

Leadtools.Dicom Assembly

Introduction

Getting Started

Namespaces

Leadtools.Dicom Namespace

Assemblies