Udostępnij za pośrednictwem

DataColumn.AutoIncrement Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll
Źródło:
DataColumn.cs
Źródło:
DataColumn.cs
Ź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; }
[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, 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.

Atrybuty
DataSysDescriptionAttribute

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.

Dotyczy

Zobacz też