PIPoint.FindPIPointsAsync Method (PIServer, IEnumerable(Int32), IEnumerable(String), CancellationToken)
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
Finds a list of PIPoint objects from the specified point ids.
Namespace: OSIsoft.AF.PI
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public static Task<IList<PIPoint>> FindPIPointsAsync( PIServer piServer, IEnumerable<int> ids, IEnumerable<string> attributeNames = null, CancellationToken cancellationToken = default )
Public Shared Function FindPIPointsAsync ( piServer As PIServer, ids As IEnumerable(Of Integer), Optional attributeNames As IEnumerable(Of String) = Nothing, Optional cancellationToken As CancellationToken = Nothing ) As Task(Of IList(Of PIPoint)) Dim piServer As PIServer Dim ids As IEnumerable(Of Integer) Dim attributeNames As IEnumerable(Of String) Dim cancellationToken As CancellationToken Dim returnValue As Task(Of IList(Of PIPoint)) returnValue = PIPoint.FindPIPointsAsync(piServer, ids, attributeNames, cancellationToken)
public: static Task<IList<PIPoint^>^>^ FindPIPointsAsync( PIServer^ piServer, IEnumerable<int>^ ids, IEnumerable<String^>^ attributeNames = nullptr, CancellationToken cancellationToken = CancellationToken() )
static member FindPIPointsAsync : piServer : PIServer * ids : IEnumerable<int> * ?attributeNames : IEnumerable<string> * ?cancellationToken : CancellationToken (* Defaults: let _attributeNames = defaultArg attributeNames null let _cancellationToken = defaultArg cancellationToken new CancellationToken() *) -> Task<IList<PIPoint>>
Parameters
- piServer
- Type: OSIsoft.AF.PIPIServer
The PIServer to search for the desired PIPoint objects. - ids
- Type: System.Collections.GenericIEnumerableInt32
The point ids of the desired PIPoint objects to search for. - attributeNames (Optional)
- Type: System.Collections.GenericIEnumerableString
The PIPoint attribute names to be loaded from the server as the PIPoint objects are found. The GetAttribute(String) method can be used to access the loaded attribute values. If , then no attribute values are loaded for the returned PIPoints. - 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: TaskIListPIPointReturns a task whose result is the list of PIPoint objects matching the specified ids.
Exceptions
| Exception | Condition |
|---|---|
| AggregateException | Asynchronous methods throw AggregateException on failure which will contain one or more exceptions containing the failure. |
Remarks
This method finds a list of PIPoint objects from the specified point ids.
| 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. |