PIPoint.UpdateValue Method (AFValue, AFUpdateOption, AFBufferOption)
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
This method writes or replaces a value in the PI Data Archive.
Namespace: OSIsoft.AF.PI
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public void UpdateValue( AFValue value, AFUpdateOption option, AFBufferOption bufferOption )
Public Sub UpdateValue ( value As AFValue, option As AFUpdateOption, bufferOption As AFBufferOption ) Dim instance As PIPoint Dim value As AFValue Dim option As AFUpdateOption Dim bufferOption As AFBufferOption instance.UpdateValue(value, option, bufferOption)
public: void UpdateValue( AFValue^ value, AFUpdateOption option, AFBufferOption bufferOption )
member UpdateValue : value : AFValue * option : AFUpdateOption * bufferOption : AFBufferOption -> unit
Parameters
- value
- Type: OSIsoft.AF.AssetAFValue
The value to be written, replaced, or removed in the PI Data Archive. - option
- Type: OSIsoft.AF.DataAFUpdateOption
An enumeration value that specifies how to treat duplicate values in the archive. It can also be used to specify that an existing value should be removed. - bufferOption
- Type: OSIsoft.AF.DataAFBufferOption
An enumeration value that specifies buffering option.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | The value is . |
| PIException | Error returned by the PI Data Archive. |
Remarks
For successful data write through Buffer, this method requires that PI Buffer Subsystem (PIBufSS) needs to be correctly pre-configured with Buffering Manager. Currently, buffering data through PIBufSS has a limitation where error feedback from PI Data Archive cannot be returned to the caller.
Data write through Buffer will be fanned to Collective members.
| Exception reporting is not handled automatically by the AF SDK. Historically, exception reporting has been handled by the application writing data (i.e. Uniint-based interfaces). |