PIServer.UpdateValues Method (IList(AFValue), AFUpdateOption)
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
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: AFErrorsAFValueIf 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.
| 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). |