DataColumn.AutoIncrement Właściwość

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Źródło:

DataColumn.cs

Pobiera lub ustawia wartość wskazującą, czy kolumna automatycznie zwiększa wartość kolumny dla nowych wierszy dodanych do tabeli.

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

Wartość właściwości

Boolean

true jeśli wartość kolumny zwiększa się automatycznie; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

ArgumentException

Kolumna jest kolumną obliczeniową.

Przykłady

Poniższy przykład ustawia AutoIncrementwłaściwości , AutoIncrementSeedi 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

Uwagi

Jeśli typ tej kolumny nie jest Int16, Int32 lub Int64, gdy ta właściwość jest ustawiona, DataType właściwość jest coerced na Int32. Wyjątek jest generowany, jeśli jest to kolumna obliczana. Właściwość jest ustawiona Expression . Wartość przyrostowa jest używana tylko wtedy, gdy wartość wiersza dla tej kolumny, po dodaniu do kolekcji kolumn, jest równa wartości domyślnej.

Nowy wiersz można utworzyć przy użyciu ItemArray właściwości DataRow klasy i przekazać tablicę wartości. Jest to potencjalny problem dla kolumny z AutoIncrement ustawionym na true, ponieważ jego wartość jest generowana automatycznie. Aby użyć ItemArray właściwości, umieść null w pozycji kolumny w tablicy. Aby uzyskać więcej informacji, zobacz ItemArray właściwość DataRow klasy.

Jeśli typ kolumny to SqlInt16 lub SqlInt32, AutoIncrement nie będzie działać. Zamiast tego użyj int16 lub Int32.

Jeśli typ kolumny to SqlInt64 lub SqlDecimal, AutoIncrement będzie działać tylko częściowo. Zamiast tego użyj wartości Int64 lub Decimal.

AutoIncrementStep Po dodaniu wartości do bieżącej wartości sprawdzanie przepełnienia jest pomijane.

Zobacz też

• AutoIncrementSeed
• AutoIncrementStep
• Expression
• ItemArray
• NewRow()
• Używanie zestawów danych w ADO.NET