DataColumn.AutoIncrement Eigenschaft

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Ruft einen Wert ab, der angibt, ob der Wert der Spalte für neu zur Tabelle hinzugefügte Zeilen in der Spalte automatisch erhöht wird, oder legt diesen fest.

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

true, wenn der Wert der Spalte automatisch erhöht wird, andernfalls false. Der Standardwert ist false.

Attribute
DataSysDescriptionAttribute

Ausnahmen

ArgumentException

Die Spalte ist eine berechnete Spalte.

Beispiele

Im folgenden Beispiel werden die AutoIncrementAutoIncrementSeedEigenschaften und AutoIncrementStep 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 ist, 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 ist festgelegt. Der inkrementierte Wert wird nur verwendet, wenn der Wert der Zeile für diese Spalte, wenn sie der Spaltenauflistung hinzugefügt wird, gleich dem Standardwert ist.

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 mit seinem AutoIncrement Satz auf true, da der Wert automatisch generiert wird. Um die ItemArray Eigenschaft zu verwenden, 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 SqlInt16 oder SqlInt32, AutoIncrement nicht funktioniert. Verwenden Sie stattdessen Int16 oder Int32.

Wenn der Typ der Spalte SqlInt64 oder SqlDecimal, AutoIncrement nur teilweise funktioniert. Verwenden Sie stattdessen Int64 oder Dezimalstellen.

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

Gilt für

Siehe auch