DataColumn.AutoIncrement Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, показывающее, увеличивать ли автоматически значение столбца для новых строк, добавляемых в таблицу.
public:
property bool AutoIncrement { bool get(); void set(bool value); };public bool AutoIncrement { get; set; }[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }member this.AutoIncrement : bool with get, set[<System.Data.DataSysDescription("DataColumnAutoIncrementDescr")>]
member this.AutoIncrement : bool with get, setPublic Property AutoIncrement As BooleanЗначение свойства
true, если значение столбца увеличивается автоматически; в противном случае — false. Значение по умолчанию — false.
- Атрибуты
Исключения
Столбец является вычисляемым.
Примеры
В следующем примере задаются AutoIncrementAutoIncrementSeedсвойства и 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 При добавлении значения к текущему значению проверка переполнения подавляется.