Click or drag to resize
OSIsoft, LLC

PIPointListLoadAttributesAsync Method

Load PIPoint attributes into the cache for each PIPoint in the list.

Namespace:  OSIsoft.AF.PI
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version:
public Task LoadAttributesAsync(
	string[] names,
	CancellationToken cancellationToken = null


Type: SystemString
The list of PIPoint attribute names to be loaded. The PICommonPointAttributes class contains some of the common PIPoint attribute names.
cancellationToken (Optional)
Type: System.ThreadingCancellationToken
A cancellation token used to abort processing before completion. Passing the default CancellationToken.None will run to completion or until the PIConnectionInfo.OperationTimeOut period elapses.

Return Value

Type: Task
Returns a task.
AggregateException Asynchronous methods throw AggregateException on failure which will contain one or more exceptions containing the failure.
The PIPoint attribute values for the specified list of attributes and points are loaded from the server into the client's cache. After loading, the PIPoint.GetAttribute method can be used to read the PIPoint attribute value. When the PIPoint attributes are no longer needed, the UnloadAttributes(String) method or the UnloadAllAttributes(String) method can be called to remove the PIPoint attributes from the cache and free memory. Beginning in AF 2.6, the LoadAttributes method will not unload previously loaded PIPoint attributes.

Note Notes to Callers
This call might use a background task to complete some of its work. See the Threading Overview for some matters to consider when execution transitions to another thread.

Version Information


Supported in: 2.10.5, 2.10, 2.9.5
See Also
Enabling Operational Intelligence