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é

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 AutoIncrementpropriétés , AutoIncrementSeedet 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 codée sur 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 pour cette colonne, lorsqu’elle est ajoutée à la collection colonnes, est égale à la valeur par défaut.

Vous pouvez créer une ligne à l’aide de la ItemArray propriété de la DataRow classe et passer un tableau de valeurs. Il s’agit d’un problème potentiel pour une colonne dont AutoIncrement la valeur est définie sur true, car sa valeur est générée automatiquement. Pour utiliser la ItemArray propriété, placez 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 fonctionnera pas. Utilisez Int16 ou Int32 à la place.

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

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

S’applique à

Voir aussi