DataColumn.AutoIncrement Свойство

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataColumn.cs

Возвращает или задает значение, указывающее, увеличивает ли столбец значение столбца для новых строк, добавленных в таблицу.

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

public bool AutoIncrement { get; set; }

member this.AutoIncrement : bool with get, set

Public Property AutoIncrement As Boolean

Значение свойства

Boolean

true Значение столбца, если значение столбца увеличивается автоматически; falseв противном случае . Значение по умолчанию — false.

Исключения

ArgumentException

Столбец — вычисляемый столбец.

Примеры

В следующем примере задаются AutoIncrementсвойства AutoIncrementSeedи AutoIncrementStep свойства.

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);
}

Private Sub AddAutoIncrementColumn()
    Dim column As 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

Комментарии

Если тип этого столбца не является Int16, Int32 или Int64 при установке этого свойства, DataType свойство принудается к Int32. Исключение создается, если это вычисляемый столбец. Свойство Expression задано. Добавочное значение используется только в том случае, если значение строки для этого столбца при добавлении в коллекцию столбцов равно значению по умолчанию.

Можно создать новую строку с помощью ItemArray свойства DataRow класса и передачи массива значений. Это потенциальная проблема для столбца со своим AutoIncrement набором true, так как его значение создается автоматически. Чтобы использовать ItemArray свойство, поместите null столбец в положение в массиве. Дополнительные сведения см. в ItemArray свойстве DataRow класса.

Если тип столбца имеет SqlInt16 или SqlInt32AutoIncrement не будет работать. Вместо этого используйте Int16 или Int32.

Если тип столбца имеет SqlInt64 или SqlDecimal, AutoIncrement будет работать только частично. Вместо этого используйте Int64 или Decimal.

AutoIncrementStep При добавлении значения к текущему значению проверка переполнения подавляется.

См. также раздел

• AutoIncrementSeed
• AutoIncrementStep
• Expression
• ItemArray
• NewRow()
• Использование наборов данных в ADO.NET