DicomObjects.NET.V8
DicomObjects Namespace / DicomDataSet Class / AddToDirectory Method / AddToDirectory(DicomDataSet,String,String) Method

Image from which to extract demographics, and (optionally) create an icon

The path is relative to where the DICOMDIR is to be written, and must conform to ISO9660/DICOM rules, and therefore be composed to up to 8 elements, each no more than 8 characters, with no extensions, separated by backslashes.

The format with which the image is to be written to disk




AddToDirectory(DicomDataSet,String,String) Method
Simplified DICOMDIR creation with specified Image, Path, TransferSyntax
Syntax
public DicomDataSetCollection AddToDirectory( 
   DicomDataSet Image,
   string Path,
   string TransferSyntax
)
public:
DicomDataSetCollection^ AddToDirectory( 
   DicomDataSet^ Image,
   String^ Path,
   String^ TransferSyntax
) 
'Declaration
 
Public Overloads Function AddToDirectory( _
   ByVal Image As DicomDataSet, _
   ByVal Path As String, _
   ByVal TransferSyntax As String _
) As DicomDataSetCollection
 
'Usage
 
Dim instance As DicomDataSet
Dim Image As DicomDataSet
Dim Path As String
Dim TransferSyntax As String
Dim value As DicomDataSetCollection
 
value = instance.AddToDirectory(Image, Path, TransferSyntax)

Parameters

Image

Image from which to extract demographics, and (optionally) create an icon

Path

The path is relative to where the DICOMDIR is to be written, and must conform to ISO9660/DICOM rules, and therefore be composed to up to 8 elements, each no more than 8 characters, with no extensions, separated by backslashes.

TransferSyntax

The format with which the image is to be written to disk

Return Value

Remarks

This method makes the creation of DICOMDIR files much easier than previously. Simply create a new DicomDataSet object, then call this method for each image to be added to the file set. A full 4-level hierarchy is automatically created.

Note that this method does not write the image file to disk, it merely adds demographics from it, and possibly an icon to the DICOMDIR DicomDataSet.

The return value is a DicomDataSetCollection object containing 4 values, referencing the PATIENT, STUDY, SERIES and IMAGE Levels of the DICOMDIR, allowing optional attributes to be added if wished.

Requirements

Target Platforms: .NET CLR 3.5 or higher

See Also