ReleaseExtensionDictionary Method (IDictionary)

ReleaseExtensionDictionary Method (IDictionary) | Send Feedback
See Also

Result[out]
  True if the extension dictionary is released and erased, false if not (see Remarks)

Releases and erases the extension dictionary of the dictionary, if the extension dictionary exists and is empty.

# Syntax

Visual Basic |
--- | ---
    Function ReleaseExtensionDictionary() As System.Boolean

C# |
--- | ---
    System.bool ReleaseExtensionDictionary()

JavaScript |
--- | ---
    ReleaseExtensionDictionary() : Boolean

COM native C++ |
--- | ---
    HRESULT ReleaseExtensionDictionary(
       VARIANT_BOOL* Result
    )

C++ |
--- | ---
    DSRESULT ReleaseExtensionDictionary(
       bool* Result
    )

#### Parameters

Result[out] or Return Value
  True if the extension dictionary is released and erased, false if not (see Remarks)

# Remarks

If the extension dictionary exists and is not empty, i.e., it contains one or more XRecords, then it is not released and erased. You must either remove or erase all XRecords from the extension dictionary before you can release and erase the extension dictionary from the dictionary. See IDictionary::RemoveEntry and IXRecord::Erased.

To restore the released and erased extension dictionary to this dictionary, call either IDictionary::CreateExtensionDictionary or IDictionary::Erased before closing the drawing. If you close the drawing before restoring the released and erased extension dictionary, then that extension dictionary is deleted from the drawing and cannot be restored.

This method also returns true if the extension dictionary does not exist.

# See Also

####

IDictionary Interface
IDictionary Members
IDictionary::GetExtensionDictionary Method ()

# Availability

DraftSight V1R4.0