DataColumn.AutoIncrement Vlastnost

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DataColumn.cs

Získá nebo nastaví hodnotu, která určuje, zda sloupec automaticky zvýší hodnotu sloupce pro nové řádky přidané do tabulky.

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

Hodnota vlastnosti

Boolean

truepokud se hodnota sloupce automaticky zvýší; v opačném případě . false Výchozí hodnota je false.

Výjimky

ArgumentException

Sloupec je počítaný sloupec.

Příklady

Následující příklad nastaví AutoIncrement, AutoIncrementSeeda AutoIncrementStep vlastnosti.

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, DataType vlastnost je přetěžována na Int32. Pokud se jedná o počítaný sloupec, vygeneruje se výjimka. Vlastnost je nastavena Expression . Přírůstková hodnota se používá pouze v případě, že se hodnota řádku pro tento sloupec při přidání do kolekce sloupců rovná výchozí hodnotě.

Nový řádek můžete vytvořit pomocí ItemArray vlastnosti DataRow třídy a předání pole hodnot. Jedná se o potenciální problém sloupce s nastavenou AutoIncrement hodnotou true, protože jeho hodnota se vygeneruje automaticky. Pokud chcete tuto vlastnost použít ItemArray , umístěte null ji do pozice sloupce v poli. Další informace naleznete ve ItemArray vlastnosti DataRow třídy.

Pokud typ sloupce je SqlInt16 nebo SqlInt32, AutoIncrement nebude fungovat. Místo toho použijte Int16 nebo Int32.

Pokud je SqlInt64 typ sloupce nebo SqlDecimal, AutoIncrement bude fungovat pouze částečně. Místo toho použijte Int64 nebo Decimal.

AutoIncrementStep Při přidání hodnoty k aktuální hodnotě je kontrola přetečení potlačena.

Viz také

• AutoIncrementSeed
• AutoIncrementStep
• Expression
• ItemArray
• NewRow()
• Použití datových sad v ADO.NET