XmlForm.Dirty Property

Reference

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.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.

Gets or sets a value that indicates whether the data in a form has been modified since it was last saved.

public:
 abstract property bool Dirty { bool get(); void set(bool value); };

public abstract bool Dirty { get; set; }

member this.Dirty : bool with get, set

Public MustOverride Property Dirty As Boolean

Property Value

Boolean

true if the data in the form has been modified since it was last saved; otherwise false.

Examples

In the following code example, the Dirty property of the XmlForm class is used to determine whether data in the form has been changed.

if (this.Dirty)
{
   MessageBox.Show("Data has been changed.");
}
else
{
   MessageBox.Show("Data has not been changed.");
}

If (Me.Dirty) Then
   MessageBox.Show("Data has been changed.")
Else
   MessageBox.Show("Data has not been changed.")
End If

Remarks

If the Dirty property is true, data in the form's underlying XML document has been changed since it was last saved. If false, no changes have occurred.

Note: Changes that occur during a Loading event will not result in the Dirty property being set to true.

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

Share via