AFElement.FindElementsByExtendedProperty Method (AFDatabase, String, IEnumerable(Guid), Int32)

public static IList<KeyValuePair<Guid, AFElement>> FindElementsByExtendedProperty(
	AFDatabase database,
	string propertyName,
	IEnumerable<Guid> values,
	int maxCount
)

Public Shared Function FindElementsByExtendedProperty ( 
	database As AFDatabase,
	propertyName As String,
	values As IEnumerable(Of Guid),
	maxCount As Integer
) As IList(Of KeyValuePair(Of Guid, AFElement))

Dim database As AFDatabase
Dim propertyName As String
Dim values As IEnumerable(Of Guid)
Dim maxCount As Integer
Dim returnValue As IList(Of KeyValuePair(Of Guid, AFElement))

returnValue = AFElement.FindElementsByExtendedProperty(database, 
	propertyName, values, maxCount)

public:
static IList<KeyValuePair<Guid, AFElement^>>^ FindElementsByExtendedProperty(
	AFDatabase^ database, 
	String^ propertyName, 
	IEnumerable<Guid>^ values, 
	int maxCount
)

static member FindElementsByExtendedProperty : 
        database : AFDatabase * 
        propertyName : string * 
        values : IEnumerable<Guid> * 
        maxCount : int -> IList<KeyValuePair<Guid, AFElement>> 

Parameters

database

Type: OSIsoft.AFAFDatabase
The AFDatabase to search for the requested objects.

propertyName

Type: SystemString
The name of the extended property to be searched.

values

Type: System.Collections.GenericIEnumerableGuid
The list of extended property values to match for the specified propertyName.

maxCount

Type: SystemInt32
The maximum number of elements to be returned from the search.

Return Value

This method will find the elements that have an extended property with the specified propertyName and its value set to one of the values in the list of specified values. All extended property values of type String and Guid on an AFElement are automatically indexed in the server to speed up the search on these types of property values. These are the only type of property values that can be searched. The QueryDate of the specified database will be used to determine the collection of elements that are returned from this method.

Notes to Callers
Only elements that have been saved to the server will be returned by this search. This search is only supported on PI AF Server 2.6 or later.

Important
Consider using the new AFElementSearch class for finding elements instead of using this method.

AFSDK

Reference