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.
In This Topic
    ReadDirectory Method
    In This Topic
    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