DataColumn.AutoIncrement Eigenschaft

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Quelle:: DataColumn.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 AutoIncrementEigenschaften , AutoIncrementSeedund AutoIncrementStep 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 ist, 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 Zeilenwert für diese Spalte beim Hinzufügen zur Spaltenauflistung dem Standardwert entspricht.

Sie können eine neue Zeile erstellen, indem Sie die ItemArray -Eigenschaft der DataRow -Klasse verwenden und ein Array von Werten übergeben. Dies ist ein potenzielles Problem für eine Spalte, deren AutoIncrement Wert auf truefestgelegt ist, da ihr Wert automatisch generiert wird. Um die ItemArray -Eigenschaft zu verwenden, platzieren null Sie an der Position der Spalte im Array. Weitere Informationen finden Sie auf der Seite zur ItemArray-Eigenschaft der DataRow-Klasse.

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

Wenn der Typ der Spalte oder SqlDecimalistSqlInt64, AutoIncrement funktioniert dies nur teilweise. Verwenden Sie stattdessen Int64 oder Decimal.

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

Gilt für: