AFContact.FindContacts Method (PISystem, String, AFSearchField, AFSortField, AFSortOrder, Int32)
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
Performs a text search within the PISystem to retrieve a collection
of AFContact objects that match the specified query string.
Namespace: OSIsoft.AF
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public static AFNamedCollectionList<AFContact> FindContacts( PISystem system, string query, AFSearchField field, AFSortField sortField, AFSortOrder sortOrder, int maxCount )
Public Shared Function FindContacts ( system As PISystem, query As String, field As AFSearchField, sortField As AFSortField, sortOrder As AFSortOrder, maxCount As Integer ) As AFNamedCollectionList(Of AFContact) Dim system As PISystem Dim query As String Dim field As AFSearchField Dim sortField As AFSortField Dim sortOrder As AFSortOrder Dim maxCount As Integer Dim returnValue As AFNamedCollectionList(Of AFContact) returnValue = AFContact.FindContacts(system, query, field, sortField, sortOrder, maxCount)
public: static AFNamedCollectionList<AFContact^>^ FindContacts( PISystem^ system, String^ query, AFSearchField field, AFSortField sortField, AFSortOrder sortOrder, int maxCount )
static member FindContacts : system : PISystem * query : string * field : AFSearchField * sortField : AFSortField * sortOrder : AFSortOrder * maxCount : int -> AFNamedCollectionList<AFContact>
Parameters
- system
- Type: OSIsoft.AFPISystem
The PISystem to search for the requested objects. - query
- Type: SystemString
The query string used for finding contacts. When searching the Name field, the query string can be the full CanonicalName of the contact to find. When the full CanonicalName is specified, the AFActiveDirectoryProperties.UserFolder setting is ignored.
The query string can include regular characters and wildcard characters. Regular characters must be match exactly the characters specified in the query string. Wildcard characters can be matched with arbitrary fragments of the query string. The syntax of the query string has the following rules:
- If or empty string, then everything will be matched.
- If no wildcards, then an exact match on the query string is performed.
- Wildcard * can be placed anywhere in the query string and matches zero or more characters. To match a literal *, then it can be escaped using the backslash (\) character (i.e. '\*').
- field
- Type: OSIsoft.AFAFSearchField
Specifies which of the object's properties are searched. - sortField
- Type: OSIsoft.AFAFSortField
The field or property of the object used to sort the returned collection. - sortOrder
- Type: OSIsoft.AFAFSortOrder
The order that the returned collection is sorted. - maxCount
- Type: SystemInt32
The maximum number of objects to be returned.
Return Value
Type: AFNamedCollectionListAFContactReturns the collection of AFContact objects which match the specified query string.
Remarks
This method will return both contacts defined by Active Directory and those specifically
added to the server.
An object matches the text search if the specified query is found
in one of the object's properties specified by the field parameter.