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

AF SDK Reference

AFPlugIn.CreateDataReferenceInstance Method

  • Last UpdatedNov 18, 2025
  • 2 minute read
AFPlugIn.CreateDataReferenceInstance Method
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: AFDataReference
Returns 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.

Version Information

AFSDK


See Also

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