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.
- Атрибуты
Исключения
Столбец является вычисляемым.
Примеры
В следующем примере задаются 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 значения к текущему значению проверка переполнения подавляется.
