AFPlugIn.CreateDataReferenceInstance Method
- Last UpdatedNov 18, 2025
- 2 minute read
- PI System
- AF SDK 2024 R2
- Developer
Create an AFDataReference instance of a plugin.
Namespace: OSIsoft.AF
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public AFDataReference CreateDataReferenceInstance( AFObject context, string configString )
Public Function CreateDataReferenceInstance ( context As AFObject, configString As String ) As AFDataReference Dim instance As AFPlugIn Dim context As AFObject Dim configString As String Dim returnValue As AFDataReference returnValue = instance.CreateDataReferenceInstance(context, configString)
public: AFDataReference^ CreateDataReferenceInstance( AFObject^ context, String^ configString )
member CreateDataReferenceInstance : context : AFObject * configString : string -> AFDataReference
Parameters
- context
- Type: OSIsoft.AFAFObject
The context object that owns the plugin instance. If specified it must be either a AFAttributeTemplate or AFAttribute. If , then the plugin instance is not associated with any object and executes without any context. - configString
- Type: SystemString
The configuration string used to initialize the plugin instance. If , then the instance will be initialized to its default values.
Return Value
Type: AFDataReferenceReturns the newly created plugin AFDataReference instance.
Remarks
Typically, it is not necessary to invoke this method, as plugin instances are created for you through SDK objects. However, in special cases, such as constructing a composite Analysis Rule, Time Rule, or Data Reference, it may be useful to invoke other plugins directly.
Before a plugin type can be used in function, its type must be defined or an exception will be thrown at runtime. To avoid this runtime error and make sure the plugin type is loaded, make a call to the GetPlugInType method before any function is called which uses the plugin type.