DataColumn.AutoIncrement Vlastnost

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Zdroj:

DataColumn.cs

Získá nebo nastaví hodnotu, která označ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í formát je false.

Výjimky

ArgumentException

Sloupec je počítaný sloupec.

Příklady

Následující příklad nastaví AutoIncrementvlastnosti , AutoIncrementSeeda 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

Poznámky

Pokud typ tohoto sloupce není Int16, Int32 nebo Int64, když je tato vlastnost nastavena, DataType je vlastnost přisouzena int32. Pokud se jedná o počítaný sloupec, vygeneruje se výjimka. Vlastnost Expression je nastavená. Přírůstková hodnota se použije 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ředat pole hodnot. Jedná se o potenciální problém pro sloupec s nastavenou AutoIncrement na true, protože jeho hodnota se generuje automaticky. Pokud chcete použít ItemArray vlastnost, umístěte null do pole pozici sloupce. Další informace najdete ve ItemArray vlastnosti DataRow třídy.

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

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

Při přidání AutoIncrementStep 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