_XDocument2.SetDirty(Boolean) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 void SetDirty(bool vfIsDirty);

public void SetDirty (bool vfIsDirty);

abstract member SetDirty : bool -> unit

Public Sub SetDirty (vfIsDirty As Boolean)

Parameters

vfIsDirty: Boolean

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

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.<span class="label">SetDirty</span>(false);

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.

Important: This member 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.

Applies to