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

AF SDK Reference

OSIsoft.AF Namespace

  • Last UpdatedNov 18, 2025
  • 12 minute read
OSIsoft.AF Namespace
The top-level OSIsoft.AF namespace contains the main classes that are used by all the other namespaces within the AF SDK. It also contains the PISystems collection which is the top level of the AF SDK hierarchy.

Classes

  ClassDescription
Public class
AFActiveDirectoryProperties
The AFActiveDirectoryProperties object is used to get and set the Active Directory configuration properties used by the PI AF Server to access contact information.
Public classCode example
AFCategories
The AFDatabase object maintains the collection of all global AFCategory collections defined on a database.
Public classCode example
AFCategory
The AFCategory represents a user-defined value used to categorize objects within the AF SDK. Use it to group objects by categories when generating reports or when making queries.
Public class
AFChangedEventArgs
Provides data for the Changed event.
Public classCode example
AFCheckOutInfo
The AFCheckOutInfo object is used to represent the checked out status information of the current object.
Public class
AFClientRegistration
AF client registration for OIDC authentication
Public class
AFCollection
Base class used for all collections in the AF SDK.
Public class
AFCollectionT
Provides the abstract base class used for all collections in the AF SDK that are indexed by unique identifier.
Public class
AFCollectionListT
A generic list of objects that does not have name lookup. This collection can be a user-defined collection of objects which belong to different objects.
Public class
AFConnectionInfo
The AFConnectionInfo object is used to provide the connection configuration information and status to the PI AF Server.
Public classCode example
AFContact
A AFContact provides contact information maintained by AF.
Public class
AFCsvColumn
Class used to represent individual columns when using CSV import and export.
Public class
AFCsvColumns
A collection of AFCsvColumn objects.
Public classCode example
AFDatabase
The AFDatabase represents a single database (data archive) in a PI AF Server.
Public classCode example
AFDatabases
The collection of AFDatabase objects maintained by the SDK for elements on the PISystem.
Public class
AFErrorsTKey
This class is used to return error information.
Public class
AFEventArgs
Base class for EventArgs that can be associated with an event in the SDK.
Public class
AFGlobalRestorer
The AFGlobalRestorer is used to restore objects persisted using the IPIPersist interface.
Public class
AFGlobalSettings
All the global application settings.
Public class
AFKeyedResultsTKey, TResult
This class is used to return a dictionary of results along with error information.
Public classCode example
AFLibraries
The collection of AFLibrary objects that provides application and domain specific information that can be loaded into a PISystem.
Public classCode example
AFLibrary
The AFLibrary is a collection of application or domain information that can be imported into an PISystem.
Public class
AFListResultsTKey, TResult
This class is used to return a list of results along with error information.
Public class
AFNamedCollectionT
Provides the abstract base class used for all collections in the AF SDK that are indexed by unique identifier and name.
Public class
AFNamedCollectionListT
A generic list of objects that support name lookups. This collection can be a user-defined collection of objects which belong to different objects.
Public class
AFNameSubstitution
This class provides support for the name substitution used with setting the names of objects.
Public class
AFObject
Base class used for all objects in the AF SDK.
Public class
AFOidcIdentity
Base object that is inherited by AFRole, AFProvider, and AFClientRegistration.
Public classCode example
AFPlugIn
The AFPlugIn contains the information about a AF plugin that is defined and installed on the PI AF Server.
Public class
AFPlugInLoadPropertiesAttribute
Attribute used on an AFPlugIn assembly to specify the AFPlugInLoadProperties used to control the loading of the plugin.
Public class
AFPlugInNonEditableConfigAttribute
Attribute used on an AFPlugIn to indicate that the editing of its configuration is not allowed in the user interface.
Public classCode example
AFPlugIns
This collection contains the list of AFPlugIn objects that are installed on the server's workstation.
Public class
AFProgressEventArgs
Provides data for a progress event.
Public class
AFProvider
AF Identity Provider
Public class
AFRole
AF Identity Provider Role
Public class
AFSDKExtension
Static class provides extension methods for classes within the AF SDK.
Public class
AFSecurity
The AFSecurity object provides access and control to the security aspects of the associated object.
Public classCode example
AFSecurityIdentities
The collection of AFSecurityIdentity objects is maintained by the PISystem (PI AF Server).
Public classCode example
AFSecurityIdentity
The AFSecurityIdentity object represents a security identity on a PISystem (PI AF Server).
Public classCode example
AFSecurityMapping
The AFSecurityMapping object represents a mapping between a Windows identity and an AFSecurityIdentity on a PISystem (PI AF Server).
Public classCode example
AFSecurityMappings
The AFSecurityMappings collection represents the available AFSecurityMapping objects on a particular PISystem (PI AF Server).
Public class
AFSecurityRightsExtension
Static class provides extension methods for AFSecurityRights enumeration.
Public class
NumericStringComparerT
Represents a numeric string comparison operation that uses special case-insensitive comparison rules for strings with numeric values.
Public classCode example
PISystem
The PISystem represents a single logical data store for the AF SDK.
Public classCode example
PISystems
The global collection of PISystem objects maintained by the AF SDK represents the known systems available from a workstation for client applications.
Public class
UniversalComparerT
A universal comparer that can be used to compare any two objects for equivalence using any combination of properties.

Structures

  StructureDescription
Public structureCode example
AFChangeInfo
The AFChangeInfo structure is used when returning information about objects that have changed in the server.
Public structure
AFPathFilter
A filter to restrict the objects found from a path.
Public structure
AFPathToken
Represents a path token from parsing an object path.
Public structure
AFPlugInSupportAssembly
Information about a support assembly for an AFPlugIn.
Public structure
AFSecurityEntry
Public structure
AFSecurityRightsToken
A security rights token is used to check security for an object.

Interfaces

  InterfaceDescription
Public interface
IAFChangedEvent
This interface defines the Changed event that is implemented on objects that support notification of changes.
Public interface
IAFList
An interface implemented by all collections in the AF SDK.
Public interface
IAFNamedCollectionT
An interface for named collections that support looking up by ID and Name.
Public interface
IAFSecurable
This interface defines the properties and methods for objects which support security.
Public interface
IAFTransactable
This interface defines the properties and methods for objects which support being transacted.
Public interface
IPIPersist
The IPIPersist interface allows a persistence string for an object to be obtained.

Enumerations

  EnumerationDescription
Public enumeration
AFAuthenticationMode
This is an enumeration that defines the possible values used when you specify the authentication mode of the PISystem.
Public enumeration
AFChangeAction
Specifies how the AFObject is changed.
Public enumeration
AFChangeInfoAction
The action that caused a object to be changed.
Public enumeration
AFCheckedOutMode
Defines the different modes that can be specified when checking in or finding modified objects.
Public enumeration
AFConnectionPreference
Defines the connection preference when connecting to an AFCollective or PICollective.
Public enumeration
AFConnectionProtocol
Defines the connection protocol used to communicate with the PI AF Server.
Public enumeration
AFContactType
This enumeration specifies the type of AFContact.
Public enumeration
AFEncodeType
Defines the different ways a reference to an object can be encoded using one of the AFObjectGetPath methods.
Public enumeration
AFErrorStatus
Defines the possible values for the error status.
Public enumeration
AFGlobalSettingsCertValidationMode
Determine level of certificate validation
Public enumeration
AFGlobalSettingsPreferOpenId
Determine default authentication behavior when connecting to PI Data Archive and AF Servers.
Public enumeration
AFIdentity
This is the enumeration used for the Identity property.
Public enumeration
AFNameSubstitutionFilters
These filters are used when requesting the list of substitution patterns.
Public enumeration
AFNameSubstitutionType
The type of substitution used by the AFNameSubstitution class.
Public enumeration
AFPathFilterType
The type of filter used when parsing an object path.
Public enumeration
AFPlugInLoadProperties
This enumeration specifies the properties for loading the assembly containing the AFPlugIn.
Public enumeration
AFProgressStatus
Specifies the status of a operation.
Public enumeration
AFSearchField
Defines the fields of the object that are searched.
Public enumeration
AFSecurityItem
The AFSecurityItem is an enumeration of the possible values for specifying security item in the method.
Public enumeration
AFSecurityMappingType
This enumeration defines the types of AFSecurityMapping.
Public enumeration
AFSecurityOperation
The operation used when adding user security rights to objects.
Public enumeration
AFSecurityRights
The AFSecurityRights is an enumeration of the possible values for specifying security access rights of objects.
Public enumeration
AFSessionSortField
Defines the AFSession field that is sorted.
Public enumeration
AFSortField
Defines the field that is sorted.
Public enumeration
AFSortOrder
Defines the sort order.
Public enumeration
AFVerifySignatureLevel
This enumeration specifies the possible levels used when verifying the signature of an assembly.
Public enumeration
PIExportMode
Indicates the type of export to perform when using an ExportXml method. Since this is a bit mask, several of these values can be set at the same time.
Public enumeration
PIImportMode
Indicates the type of import to perform when using an ImportXml or ImportCsvmethod. Since this is a bit mask, several of these values can be set at the same time.
Public enumeration
PISystemFeatures
This enumeration represents the features that may be enabled or disabled for the PISystem.
Public enumeration
PISystemsAFDirectoryOptions
Defines the directory options used when looking up a PISystem in the PISystems collection or a PIServer in the PIServers collection.
In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in