Show All

# IsDOMReadOnly Property

A read-only property that returns a Boolean value that indicates whether the data in the underlying XML document of a Microsoft Office InfoPath 2003 form has been placed in a read-only state.

expression.IsDOMReadOnly

expression Required. An expression that returns a reference to an XDocument object.

## Security Level

2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

## Remarks

If the IsDOMReadOnly property is True, data in the form's underlying XML document is in a read-only state and cannot be changed. If False, the data in the form's underlying XML document can be changed.

To determine whether the form has been placed in a read-only state, use the IsReadOnly property of the XDocument object.

The data in a form's XML document will be placed in a read-only state in the following scenarios:

- The form is digitally signed
- The form is in Reduced Functionality Mode (RFM) mode
- During the OnBeforeChange event
- During the OnValidate event
- During an undo or redo operation

## Example

In the following example, the IsDOMReadOnly property of the XDocument object is used to determine whether data in the form's underlying XML document has been placed in a read-only state. If it has, a `return` statement is used to exit the event handler.

    function msoxd__item::OnAfterChange(objEvent)
    {

       // Determine whether the XML DOM is read-only.
       if (XDocument.IsDOMReadOnly)
          return;

       // Continue normal processing...

    }

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp