ArcObjects Library Reference (GeoDatabase)  

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

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

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:

 

See Also

IFeatureWorkspace Interface

.NET Snippets

Create Table |

.NET Samples

Import signposts (Code Files: SignpostUtilities) |

.NET Related Topics

Creating tables |