通过

DataColumn.AutoIncrement 属性

  • 项目

获取或设置一个值，该值指示对于添加到该表中的新行，列是否将列的值自动递增。

**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
Public Property AutoIncrement As Boolean
用法
Dim instance As DataColumn
Dim value As Boolean

value = instance.AutoIncrement

instance.AutoIncrement = value

public bool AutoIncrement { get; set; }

public:
property bool AutoIncrement {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_AutoIncrement ()

/** @property */
public void set_AutoIncrement (boolean value)

public function get AutoIncrement () : boolean

public function set AutoIncrement (value : boolean)

属性值

如果列的值自动递增，则为 true；否则为 false。默认为 false。

异常

异常类型 条件

ArgumentException

该列是计算所得的列。

备注

如果在设置此属性时此列的类型不是 Int16、Int32 或 Int64，则将 DataType 属性强迫为 Int32。如果这是计算所得的列，则将生成异常。将设置 Expression 属性。只有当此列被添加到列集合时，其行的值等于默认值的情况下，才使用递增的值。

可以使用 DataRow 类的 ItemArray 属性并传入值的数组，来创建新行。对于其 AutoIncrement 设置为 true 的列，这是一个潜在的问题，因为其值是自动生成的。若要使用 ItemArray 属性，请将 空引用（在 Visual Basic 中为 Nothing） 放入数组中的列的位置。有关更多信息，请参见 DataRow 类的 ItemArray 属性。

示例

下面的示例设置 AutoIncrement、AutoIncrementSeed 和 AutoIncrementStep 属性。

Private Sub AddAutoIncrementColumn()
    Dim column As DataColumn = New DataColumn
    column.DataType = System.Type.GetType("System.Int32")
    With column
        .AutoIncrement = True
        .AutoIncrementSeed = 1000
        .AutoIncrementStep = 10
    End With

    ' Add the column to a new DataTable.
    Dim table As DataTable
    table = New DataTable
    table.Columns.Add(column)
End Sub

private void AddAutoIncrementColumn()
{
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1000;
    column.AutoIncrementStep = 10;

    // Add the column to a new DataTable.
    DataTable table = new DataTable("table");
    table.Columns.Add(column);
}

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

DataColumn 类
DataColumn 成员
System.Data 命名空间
AutoIncrementSeed
AutoIncrementStep
Expression
ItemArray
NewRow