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

AF SDK Reference

PIServer.UpdateValues Method (IList(AFValue), AFUpdateOption)

PIServer.UpdateValues Method (IList(AFValue), AFUpdateOption)

  • Last UpdatedNov 18, 2025
  • 3 minute read
PIServer.UpdateValues Method (IList(AFValue), AFUpdateOption)
Update, write or delete the PIPoint value for each AFValue in the specified list.

Namespace:  OSIsoft.AF.PI
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182

Syntax

public AFErrors<AFValue> UpdateValues(
	IList<AFValue> values,
	AFUpdateOption option
)
Public Function UpdateValues ( 
	values As IList(Of AFValue),
	option As AFUpdateOption
) As AFErrors(Of AFValue)

Dim instance As PIServer
Dim values As IList(Of AFValue)
Dim option As AFUpdateOption
Dim returnValue As AFErrors(Of AFValue)

returnValue = instance.UpdateValues(values, 
	option)
public:
AFErrors<AFValue^>^ UpdateValues(
	IList<AFValue^>^ values, 
	AFUpdateOption option
)
member UpdateValues : 
        values : IList<AFValue> * 
        option : AFUpdateOption -> AFErrors<AFValue> 

Parameters

values
Type: System.Collections.GenericIListAFValue
The list of values with an associated PIPoint to be inserted, replaced, or removed to 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 existing values should be removed.

Return Value

Type: AFErrorsAFValue
If there are no errors, then is returned. Otherwise an AFErrorsTKey instance containing error information is returned.

Remarks

This method will take the list of values with an associated PIPoint and update multiple values for multiple points. Multiple values for the same PIPoint can be in the list. The value's PIPoint must be set or its Attribute must be set to an AFAttribute associated with a PIPoint.

If not specified in AFSDK.config, the AFBufferOption is defaulted to BufferIfPossible. The default buffering option for the current AF SDK client instance can be modified via the static property AFData.BufferOption.

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


See Also

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