AFValueStatus Enumeration
- 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
[FlagsAttribute] public enum AFValueStatus
<FlagsAttribute> Public Enumeration AFValueStatus Dim instance As AFValueStatus
[FlagsAttribute] public enum class AFValueStatus
[<FlagsAttribute>] type AFValueStatus
Members
| Member name | Value | Description | |
|---|---|---|---|
| Bad | 0 | Indicates the value is bad. | |
| Questionable | 64 | The value has been identified as irregular in some way by an application. | |
| Good | 192 | Indicates the value is good. | |
| QualityMask | 192 | Mask for Bad, Questionable (Uncertain), and Good quality status. | |
| SubstatusMask | 60 | Mask for quality substatus bits. The only substatus bit defined is Substituted. | |
| BadSubstituteValue | 60 | A Bad quality substatus value which indicates the value has been substituted with a bad value. | |
| UncertainSubstituteValue | 8 | A Questionable quality substatus value which indicates the value has been substituted. | |
| Substituted | 24 | A Good quality substatus value which indicates the value has been replaced after it was originally written. If the value is obtained from an AFCase and is adjusted, this flag will be set. | |
| Constant | 3 | Indicates the value contains an constant value which is not expected to change at runtime. | |
| Annotated | 32768 | Indicates the value contains an annotation. For values retrieved from the PI Archive, use the underlying PIPoint to obtain the value of the annotation. |
Remarks
When obtaining the value of an attribute, the AFValue.Status property will indicate the status of the value. You can also use the AFValue.IsGood, AFValue.Substituted, AFValue.Questionable, and AFValue.Annotated properties directly. If you are inter-operating with another system, it may be more efficient to access the values and status using the AFValues.GetValueArrays method which returns the status information as flags.
The quality bit field, obtained with the QualityMask, may be one of three values: Bad, Questionable, or Good. The sub-status bits, SubstatusMask, contain additional information of the quality, based on the overall quality.