DataColumn.AutoIncrement Свойство

Определение

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

System.Data

Сборка:

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 или SqlInt32, AutoIncrement не будет работать. Вместо этого используйте Int16 или Int32.

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

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

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

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