Freigeben über

DataColumn.AutoIncrement Eigenschaft

Definition

Namespace:
System.Data
Assemblys:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte automatisch den Wert der Spalte für neue Zeilen erhöht, die der Tabelle hinzugefügt werden.

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

Eigenschaftswert

Boolean

truewenn der Wert der Spalte automatisch erhöht wird; andernfalls . false Der Standardwert lautet false.

Attribute
DataSysDescriptionAttribute

Ausnahmen

ArgumentException

Die Spalte ist eine berechnete Spalte.

Beispiele

Im folgenden Beispiel werden die AutoIncrementEigenschaften , AutoIncrementSeed, und AutoIncrementStep die Eigenschaften festgelegt.

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

Hinweise

Wenn der Typ dieser Spalte nicht "Int16", "Int32" oder "Int64" lautet, wenn diese Eigenschaft festgelegt wird, wird die DataType Eigenschaft in Int32 umgewandelt. Eine Ausnahme wird generiert, wenn es sich um eine berechnete Spalte handelt. Die Expression Eigenschaft wird festgelegt. Der inkrementierte Wert wird nur verwendet, wenn der Wert der Zeile für diese Spalte, wenn sie der Spaltenauflistung hinzugefügt wird, dem Standardwert entspricht.

Sie können eine neue Zeile mithilfe der ItemArray Eigenschaft der DataRow Klasse erstellen und ein Array von Werten übergeben. Dies ist ein potenzielles Problem für eine Spalte, deren AutoIncrement Wert auf "festgelegt" festgelegt trueist, da der Wert automatisch generiert wird. Wenn Sie die ItemArray Eigenschaft verwenden möchten, platzieren null Sie die Position der Spalte im Array. Weitere Informationen finden Sie in der ItemArray Eigenschaft der DataRow Klasse.

Wenn der Typ der Spalte oder SqlInt16SqlInt32, AutoIncrement funktioniert nicht. Verwenden Sie stattdessen Int16 oder Int32.

Wenn der Typ der Spalte oder SqlInt64SqlDecimal, AutoIncrement nur teilweise funktioniert. Verwenden Sie stattdessen Int64 oder Dezimalzeichen.

Wenn der AutoIncrementStep Wert dem aktuellen Wert hinzugefügt wird, wird die Überlaufüberprüfung unterdrückt.

Gilt für:

Weitere Informationen