DicomObjects Reference
DicomObjects Reference / DicomDataSets Collection / ReadDirectory Method
The name of the file to read.
This is passed unmodified to the operating system, and it is therefore the container’s responsibility to ensure either that the file exists within the current directory, or that a fully qualified filename is provided.
ReadDirectory Method
Description
Reads a dataset from a DICOMDIR file
Syntax
Visual Basic
Public Function ReadDirectory( _
   ByVal FileName As String _
) As DicomDataSet
Parameters
FileName
The name of the file to read.
This is passed unmodified to the operating system, and it is therefore the container’s responsibility to ensure either that the file exists within the current directory, or that a fully qualified filename is provided.
Remarks

This method is used for reading the “DICOMDIR” files used on exchangeable media.  Although such files could simply be read using ReadFile, the item offset information necessary for interpretation of the hierarchical directory structure would be lost.  This method preserves such information, placing a copy of each of the entries in the root directory in the Children collection of the returned dataset.  Likewise, levels below the root are also represented by the Children property of the level above.

The file may have been written by the WriteDirectory method or by other DICOM software.
See the security page for details of restrictions on this method.

See Also