DataColumn.AutoIncrement Propriété

Définition

Obtient ou définit une valeur qui indique si la colonne incrémente automatiquement la valeur de la colonne pour les nouvelles lignes ajoutées à la table.

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

Valeur de propriété

Boolean

true si la valeur de la colonne est automatiquement incrémentée ; sinon, false. La valeur par défaut est false.

Attributs

Exceptions

La colonne est une colonne calculée.

Exemples

L’exemple suivant définit les AutoIncrement AutoIncrementSeed Propriétés, et 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

Remarques

Si le type de cette colonne n’est pas Int16, Int32 ou Int64 lorsque cette propriété est définie, la DataType propriété est forcée à Int32. Une exception est générée s’il s’agit d’une colonne calculée. La Expression propriété est définie. La valeur incrémentée est utilisée uniquement si la valeur de la ligne de cette colonne, lorsqu’elle est ajoutée à la collection Columns, est égale à la valeur par défaut.

Vous pouvez créer une nouvelle ligne à l’aide ItemArray de la propriété de la DataRow classe et en passant un tableau de valeurs. Il s’agit d’un problème potentiel pour une colonne dont la AutoIncrement true valeur est, car sa valeur est générée automatiquement. Pour utiliser la ItemArray propriété, placez-la à null la position de la colonne dans le tableau. Pour plus d’informations, consultez la ItemArray propriété de la DataRow classe.

Si le type de la colonne est SqlInt16 ou SqlInt32 , AutoIncrement ne fonctionne pas. Utilisez à la place Int16 ou Int32.

Si le type de la colonne est SqlInt64 ou SqlDecimal , AutoIncrement ne fonctionne que partiellement. Utilisez à la place Int64 ou Decimal.

Lorsque la AutoIncrementStep valeur est ajoutée à la valeur actuelle, la vérification de dépassement de capacité est supprimée.

S’applique à

Voir aussi