AFAttribute.IsConfigurationItem Property
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
Namespace: OSIsoft.AF.Asset
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public bool IsConfigurationItem { get; set; }
Public Property IsConfigurationItem As Boolean Get Set Dim instance As AFAttribute Dim value As Boolean value = instance.IsConfigurationItem instance.IsConfigurationItem = value
public: virtual property bool IsConfigurationItem { bool get () sealed; void set (bool value) sealed; }
abstract IsConfigurationItem : bool with get, set override IsConfigurationItem : bool with get, set
Property Value
Type: BooleanDetermines whether this attribute is a configuration item for the associated element. The default value is if the attribute is not created from a template.
Implements
IAFAttributeIsConfigurationItem
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | Cannot set this property if the attribute is defined by a template or is a dynamic attribute. |
Remarks
If this property is , then changes to the attribute's value are treated as configuration changes to the owning element. This means that any changes to the value of this attribute will cause the owning element to become dirty and will require a call to the owning element's IAFTransactable.CheckIn method before the changes are saved to persistent storage. If this property is , then any changes to the attribute's value do not affect the element's dirty flag and are written immediately to persistent storage, unless it is written within the context of a case, which delays the write until the case is published.
If this attribute was created from an AFAttributeTemplate, then the value of this property is defined by the template and cannot be changed. In this case, changing the AFAttributeTemplate.IsConfigurationItem property also changes the value of this property. If the attribute was NOT created from a template, then this property can be modified and defaults to a value of .
| If the attribute was not created from a template, then setting the DataReferencePlugIn will automatically set this property to . |