AFTables.Add Method (String, Object)
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
The Add method creates a new object at the specified effective date and adds it to the collection.
Namespace: OSIsoft.AF.Asset
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public AFTable Add( string name, Object effectiveDate )
Public Function Add ( name As String, effectiveDate As Object ) As AFTable Dim instance As AFTables Dim name As String Dim effectiveDate As Object Dim returnValue As AFTable returnValue = instance.Add(name, effectiveDate)
public: AFTable^ Add( String^ name, Object^ effectiveDate )
member Add : name : string * effectiveDate : Object -> AFTable
Parameters
- name
- Type: SystemString
The name for the new object, which must be unique within the collection. If the name ends with an asterisk (*), then a unique name will be generated based on the supplied name. See the ValidateName(String, String) method for a description of what is valid when setting the name of the object. - effectiveDate
- Type: SystemObject
The effective date for the newly created object. The value may be an AFTime, DateTime, PITime, String, or numeric. A DateTime (or a DATE will be treated as UTC time if its Kind property is set to Unspecified. Because DATE values from COM or VB6 clients are marshalled as Unspecified, these client applications must convert to UTC prior to marshalling. An integer numeric represents the number of ticks (100-nanosecond intervals) since January 1, 0001. A floating point numeric represents the number of seconds since January 1, 1970 UTC. A String is interpreted as local time, unless it contains a time zone indicator such as a trailing "Z" or "GMT". Strings will be interpreted with the AFTime.Parse Overload methods so that relative formats with intervals ("*", "T+3h", etc.) are also supported. Relative time intervals are based on AFTime.Now.
Return Value
Type: AFTableReturns the newly created object that was added to the collection.
Remarks
The new object will be created with the specified name and effectiveDate.
All other properties of the object will be set to their default value.