InsertColumn Method

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The InsertColumn method adds a column to the Columns collection of a Table object at the position indicated.

Syntax

object
.InsertColumn(
Column
,
InsertBeforeColumn
)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • Column
    Expression that evaluates to a Column object.

  • InsertBeforeColumn
    String that names an existing Column object in the Columns collection of a Table object.

Prototype (C/C++)

HRESULT InsertColumn(
LPSQLDMOCOLUMN pNewColumn,
SQLDMO_LPCSTR szBeforeColumn);

Remarks

Use the InsertColumn method when the ordinal position of a column must be maintained.

Note

Columns in existing Microsoft SQL Server tables have fixed ordinal location. You cannot use the InsertColumn method when the Table object references an existing SQL Server table. Use InsertColumn only when the Table object is used to create a SQL Server table.

Applies To: