_XDocument3.SetDirty method (Boolean)

Sets the IsDirty property for the XDocument object, which indicates whether the data in a Microsoft Office InfoPath form has been modified since it was last saved.

Namespace:  Microsoft.Office.Interop.InfoPath
Assembly:  Microsoft.Office.Interop.InfoPath (in Microsoft.Office.Interop.InfoPath.dll)

Syntax

'Declaration
Sub SetDirty ( _
    vfIsDirty As Boolean _
)
'Usage
Dim instance As _XDocument3
Dim vfIsDirty As Boolean

instance.SetDirty(vfIsDirty)
void SetDirty(
    bool vfIsDirty
)

Parameters

  • vfIsDirty
    Type: System.Boolean

    Specifies whether the form is to be marked as unmodified or not.

Implements

_XDocument2.SetDirty(Boolean)

Remarks

The SetDirty method can be used from the OnSubmitRequest event to force a document to be marked as unchanged. InfoPath will therefore not request the user to save the form when it is closed.

The SetDirty method can also be used from the OnSaveRequest event to programmatically mark the form as changed or unchanged since it was last saved.

Examples

In the following example, the IsDirty property of the current form is set to false so that the user will not be prompted to save the form when it is closed.

thisXDocument.SetDirty(false);

See also

Reference

_XDocument3 interface

_XDocument3 members

SetDirty overload

Microsoft.Office.Interop.InfoPath namespace