AF SDK Reference

PIServer.CreatePIPoints Method (IEnumerable(String), IDictionary(String, Object))

Save PDF

TABLE OF CONTENTS

PIServer.CreatePIPoints Method (IEnumerable(String), IDictionary(String, Object))

Save PDF

Last UpdatedNov 18, 2025
3 minute read

Create a list of new PIPoint objects on the current PIServer with all points having the same attribute values.

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

Syntax

public AFListResults<string, PIPoint> CreatePIPoints(
	IEnumerable<string> pointNames,
	IDictionary<string, Object> attributeValues = null
)

Public Function CreatePIPoints ( 
	pointNames As IEnumerable(Of String),
	Optional attributeValues As IDictionary(Of String, Object) = Nothing
) As AFListResults(Of String, PIPoint)

Dim instance As PIServer
Dim pointNames As IEnumerable(Of String)
Dim attributeValues As IDictionary(Of String, Object)
Dim returnValue As AFListResults(Of String, PIPoint)

returnValue = instance.CreatePIPoints(pointNames, 
	attributeValues)

public:
AFListResults<String^, PIPoint^>^ CreatePIPoints(
	IEnumerable<String^>^ pointNames, 
	IDictionary<String^, Object^>^ attributeValues = nullptr
)

member CreatePIPoints : 
        pointNames : IEnumerable<string> * 
        ?attributeValues : IDictionary<string, Object> 
(* Defaults:
        let _attributeValues = defaultArg attributeValues null
*)
-> AFListResults<string, PIPoint>

Parameters

pointNames: Type: System.Collections.GenericIEnumerableString
The list of names for the new PIPoint objects being created.
attributeValues (Optional): Type: System.Collections.GenericIDictionaryString, Object
A dictionary of attribute values for all the new PIPoint objects being created. The dictionary key is the name of the attribute to be modified and the dictionary value is the new value for the attribute. The attribute values will be the same for each PIPoint created. If , then the PIPoint objects will be created with default attribute values.

Return Value

Type: AFListResultsString, PIPoint
Returns 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 with the same set of attribute values. The attributes for the new PIPoint can be set using the attributeValues parameter or with the PIPoint.SetAttribute method after creation.

AF SDK Reference