This documentation is archived and is not being maintained.

SettingsPropertyValue.IsDirty Property

Gets or sets whether the value of a SettingsProperty object has changed.

Namespace:  System.Configuration
Assembly:  System (in System.dll)

public bool IsDirty { get; set; }

Property Value

Type: System.Boolean
true if the value of a SettingsProperty object has changed; otherwise, false.

The IsDirty property indicates that the value stored by this class has changed. The default is false. The IsDirty property is set to true under the following conditions:

  1. The value contained in the SettingsPropertyValue object is changed.

  2. The value contained in the SettingsPropertyValue object is accessed, and the value is not a string or a primitive type such as int, float, real, or DateTime. When the value managed by a SettingsPropertyValue object is a complex type (for example an ArrayList), there is no way for a SettingsPropertyValue object to detect when changes have been made. As a result, the SettingsPropertyValue object pessimistically assumes that a complex type is dirty once it has been accessed from the PropertyValue property.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: