DataColumn.AutoIncrement Vlastnost

Definice

Získává nebo nastavuje hodnotu, která indikuje, jestli sloupec automaticky zvýší hodnotu sloupce pro nové řádky přidané do tabulky.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

public:
 property bool AutoIncrement { bool get(); void set(bool value); };
[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }
member this.AutoIncrement : bool with get, set
Public Property AutoIncrement As Boolean

Hodnota vlastnosti

true, pokud se hodnota sloupce zvýší automaticky; v opačném případě false.true if the value of the column increments automatically; otherwise, false. Výchozí hodnota je false.The default is false.

Atributy

Výjimky

Sloupec je vypočítaný sloupec.The column is a computed column.

Příklady

Následující příklad nastaví vlastnosti AutoIncrement, AutoIncrementSeeda AutoIncrementStep.The following example sets the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties.

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

Poznámky

Pokud typ tohoto sloupce není Int16, Int32 nebo Int64, pokud je tato vlastnost nastavena, vlastnost DataType je převedena na typ Int32.If the type of this column is not Int16, Int32, or Int64 when this property is set, the DataType property is coerced to Int32. Pokud se jedná o vypočítaný sloupec, vygeneruje se výjimka.An exception is generated if this is a computed column. Vlastnost Expression je nastavena.The Expression property is set. Přírůstková hodnota se používá pouze v případě, že hodnota řádku pro tento sloupec, je-li přidána do kolekce sloupců, je shodná s výchozí hodnotou.The incremented value is used only if the row's value for this column, when added to the columns collection, is equal to the default value.

Nový řádek lze vytvořit pomocí vlastnosti ItemArray třídy DataRow a předáním pole hodnot.You can create a new row using the ItemArray property of the DataRow class and passing in an array of values. Toto je potenciální problém pro sloupec s jeho AutoIncrement nastavenou na true, protože jeho hodnota se vygeneruje automaticky.This is a potential problem for a column with its AutoIncrement set to true, because its value is generated automatically. Chcete-li použít vlastnost ItemArray, umístěte null do pozice sloupce v poli.To use the ItemArray property, place null in the column's position in the array. Další informace najdete v tématu ItemArray vlastnost DataRow třídy.For more information, see the ItemArray property of the DataRow class.

Pokud je typ sloupce SqlInt16 nebo SqlInt32, AutoIncrement nebude fungovat.If the type of the column is SqlInt16 or SqlInt32, AutoIncrement will not work. Místo toho použijte Int16 nebo Int32.Use Int16 or Int32 instead.

Pokud je typ sloupce SqlInt64 nebo SqlDecimal, AutoIncrement bude pouze částečně fungovat.If the type of the column is SqlInt64 or SqlDecimal, AutoIncrement will only partially work. Místo toho použijte Int64 nebo Decimal.Use Int64 or Decimal instead.

Pokud je hodnota AutoIncrementStep přidána na aktuální hodnotu, je potlačena tato kontrolu.When the AutoIncrementStep value is added to the current value, the overflow check is suppressed.

Platí pro

Viz také