RejectInvalidFileId Property

Gets or sets a value indicating whether the methods of the DicomDir class that take a filename as a parameter should fail if the number of components in the File ID exceeds 8 or if the number of characters in any component of the File ID exceeds 8.

Syntax

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

public bool RejectInvalidFileId {get; set;}

'Declaration
 
Public Property RejectInvalidFileId As Boolean

'Usage
 
Dim instance As DicomDirOptions
Dim value As Boolean
 
instance.RejectInvalidFileId = value
 
value = instance.RejectInvalidFileId

public bool RejectInvalidFileId {get; set;}

ObjectiveC Syntax

Java Syntax

 get_RejectInvalidFileId();
set_RejectInvalidFileId(value);

public:
property bool RejectInvalidFileId {
   bool get();
   void set (    bool value);
}

Property Value

true if the methods of the DicomDir class that take a filename as a parameter should fail if the number of components in the File ID exceeds 8 or if the number of characters in any component of the File ID exceeds 8 (the latter case is possible only for the last component, since the short format of filenames is used for File IDs); otherwise, false.

Remarks

As an example, if the destination folder is specified as "C:\DICOM Images\", then the following filenames will be rejected if RejectInvalidFileId is set to true:

"C:\DICOM Images\Sub1\Sub2\Sub3\Sub4\Sub5\Sub6\Sub7\Sub8\Brain"

"C:\DICOM Images\Patient 1\CT-10-Knee.dic"

The first filename is rejected because the number of components in the File ID exceeds 8 (there are 9 components, starting from "Sub1"). The second filename is rejected because the number of characters in the last component, which is the short format of "CT-10-Knee.dic" (e.g., "CT-10-~1.dic") exceeds 8. On the other hand, the following filenames will not be rejected:

"C:\DICOM Images\Sub1\Sub2\Sub3\Sub4\Sub5\Sub6\Sub7\Brain"

"C:\DICOM Images\ Patient 1\Knee.dic"

Example

For an example, refer to DicomDir.Reset.

Requirements

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

DicomDirOptions Structure
DicomDirOptions Members
InsertFile Method
InsertDataSet Method
SetDescriptorFile Method