PIServer.CreatePIPoints Method (IDictionary(String, IDictionary(String, Object)))
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
Create a list of new PIPoint objects on the current PIServer with
each point having a different set of attribute values.
Namespace: OSIsoft.AF.PI
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public AFListResults<string, PIPoint> CreatePIPoints( IDictionary<string, IDictionary<string, Object>> definitions )
Public Function CreatePIPoints ( definitions As IDictionary(Of String, IDictionary(Of String, Object)) ) As AFListResults(Of String, PIPoint) Dim instance As PIServer Dim definitions As IDictionary(Of String, IDictionary(Of String, Object)) Dim returnValue As AFListResults(Of String, PIPoint) returnValue = instance.CreatePIPoints(definitions)
public: AFListResults<String^, PIPoint^>^ CreatePIPoints( IDictionary<String^, IDictionary<String^, Object^>^>^ definitions )
member CreatePIPoints : definitions : IDictionary<string, IDictionary<string, Object>> -> AFListResults<string, PIPoint>
Parameters
- definitions
- Type: System.Collections.GenericIDictionaryString, IDictionaryString, Object
A dictionary of point definitions for the new PIPoint objects being created. The dictionary key is the name of the PIPoint to be created and the dictionary value is a dictionary of attribute values for the new PIPoint. The attribute value dictionary key is the name of the attribute to be modified and the attribute value dictionary value is the new value for the attribute. If the attribute value dictionary is , then the PIPoint will be created with default attribute values.
Return Value
Type: AFListResultsString, PIPointReturns the list of newly created PIPoint objects along with any error results.
Exceptions
| Exception | Condition |
|---|---|
| AggregateException | If one or more of the PI Point attribute names are invalid. |
| PIException | If one or more of the PI Point attribute values are invalid and rejected by the server. |
Remarks
This method is used to create a list of new PIPoint objects on the current
PIServer and allow each new PIPoint to have a different
set of attribute values. The name of the PIPoint and its corresponding
set of attribute values is specified in the definitions parameter.
The attribute values for a PIPoint can also be set with the
PIPoint.SetAttribute method after creation.