Share via

XDocument.IsDOMReadOnly Property

  • Article
InfoPath Developer Reference

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

Version Information
 Version Added:  InfoPath 2003

Syntax

expression.IsDOMReadOnly

expression   An expression that returns a XDocument object.

Return Value
Boolean

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

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.

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.

JScript 
  function msoxd__item::OnAfterChange(objEvent)
{

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


// Continue normal processing...


}

See Also