Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AF SDK Reference

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

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

  • Last UpdatedNov 18, 2025
  • 3 minute read
PIServer.CreatePIPoints Method (IDictionary(String, IDictionary(String, Object)))
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, PIPoint
Returns the list of newly created PIPoint objects along with any error results.

Exceptions

ExceptionCondition
AggregateExceptionIf one or more of the PI Point attribute names are invalid.
PIExceptionIf 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.

Version Information

AFSDK


See Also

In This Topic
TitleResults for “How to create a CRG?”Also Available in