DataColumn.AutoIncrement Propriété

  • Référence

Définition

Espace de noms:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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
DataSysDescriptionAttribute

Exceptions

ArgumentException

La colonne est une colonne calculée.

Exemples

L’exemple suivant définit les propriétés et AutoIncrementStep AutoIncrementSeedles AutoIncrementpropriétés.

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 coerced 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 de 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 avec sa AutoIncrement valeur définie 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 fonctionne partiellement. Utilisez Int64 ou Decimal à la place.

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

S’applique à

Voir aussi