IFeatureWorkspace.CreateTable Method

Creates a new table.

[Visual Basic .NET]
Public Function CreateTable ( _
    ByVal Name As String, _
    ByVal Fields As IFields, _
    ByVal CLSID As UID, _
    ByVal EXTCLSID As UID, _
    ByVal ConfigKeyword As String _
) As ITable

[C#]
public ITable CreateTable (
    string Name,
    IFields Fields,
    UID CLSID,
    UID EXTCLSID,
    string ConfigKeyword
);

[C++]
HRESULT CreateTable(
  BSTR Name,
  IFields* Fields,
  IUID* CLSID,
  IUID* EXTCLSID,
  BSTR ConfigKeyword,
  ITable** Table
);

[C++]
Parameters
Name [in]
  Name is a parameter of type BSTR
Fields [in]
  Fields is a parameter of type IFields
CLSID [in]
  CLSID is a parameter of type IUID
EXTCLSID [in]
  EXTCLSID is a parameter of type IUID
ConfigKeyword [in]
  ConfigKeyword is a parameter of type BSTR
Table [out, retval]
  Table is a parameter of type ITable

Product Availability

Functional License Check

If your application/site is not appropriately licensed, CreateTable can return an Err.Number of FDO_E_NO_SCHEMA_LICENSE.

Remarks

The CreateTable method can be used to create a new table or object class in the workspace.

The optional CLSID and EXTCLSID parameters allow the calling application to specify the GUIDs for the objects that implement the instance and the class extension behavior for an object class. If no CLSID is passed in, then the resulting table is not registered in the geodatabase object class data dictionary (It will support the IObjectClass interface but will have an ObjectClassID of –1). Valid values for CLSID are esriGeoDatabase.Object or any non-spatial object that extends esriGeoDatabase.Object. CLSID must be set in order to apply a class extension with the EXTCLSID parameter.

The Fields object passed to the Fields parameter should not be an object retrieved from another class. If the new class is going to have the same fields as an existing class, cast the existing class' fields collection to the IClone interface, clone it, and use the cloned fields collection as input for this method.

The optional configurationKeyword parameter allows the application to control the physical layout for this table in the underlying RDBMS. For example, in an Oracle database, the configuration keyword controls the tablespace in which the table is created, the initial and next extents, and other properties. The configuration keywords for an ArcSDE instance are set up by the ArcSDE data administrator, the list of available keywords supported by a workspace may be obtained using the IWorkspaceConfiguration interface.

Note: Table or feature class names with the following prefixes are not supported:

• "gdb_"
• "sde_"
• "delta_"

See Also