Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AF SDK Reference

PIPoint.UpdateValue Method (AFValue, AFUpdateOption, AFBufferOption)

PIPoint.UpdateValue Method (AFValue, AFUpdateOption, AFBufferOption)

  • Last UpdatedNov 18, 2025
  • 3 minute read
PIPoint.UpdateValue Method (AFValue, AFUpdateOption, AFBufferOption)
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

ExceptionCondition
ArgumentNullException The value is .
PIExceptionError 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.

Important note Important
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).

Version Information

AFSDK

Supported in: 3.1.1, 3.1.0, 3.0.2, 3.0.1, 3.0.0, 2.10.11, 2.10.5, 2.10.0, 2.10, 2.9.5, 2.9, 2.8.5, 2.8, 2.7.5, 2.7, 2.6

See Also

In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in