DataColumn.AutoIncrement DataColumn.AutoIncrement DataColumn.AutoIncrement DataColumn.AutoIncrement Property

Définition

Obtient ou définit une valeur qui indique si la colonne s’incrémente automatiquement la valeur de la colonne pour les nouvelles lignes ajoutées à la table.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

public:
 property bool AutoIncrement { bool get(); void set(bool value); };
[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }
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.true if the value of the column increments automatically; otherwise, false. La valeur par défaut est false.The default is false.

Exceptions

La colonne est une colonne calculée.The column is a computed column.

Exemples

L’exemple suivant définit la AutoIncrement, AutoIncrementSeed, et AutoIncrementStep propriétés.The following example sets the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties.

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 DataColumn = 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, le DataType propriété est convertie en Int32.If the type of this column is not Int16, Int32, or Int64 when this property is set, the DataType property is coerced to Int32. Une exception est générée s’il s’agit d’une colonne calculée.An exception is generated if this is a computed column. Le Expression propriété est définie.The Expression property is set. La valeur incrémentée est utilisée uniquement si la valeur de la ligne pour cette colonne est ajouté à la collection de colonnes, est égale à la valeur par défaut.The incremented value is used only if the row's value for this column, when added to the columns collection, is equal to the default value.

Vous pouvez créer une nouvelle ligne en utilisant le ItemArray propriété de la DataRow classe et en passant un tableau de valeurs.You can create a new row using the ItemArray property of the DataRow class and passing in an array of values. Il s’agit d’un problème potentiel pour une colonne avec sa AutoIncrement défini sur true, car sa valeur est générée automatiquement.This is a potential problem for a column with its AutoIncrement set to true, because its value is generated automatically. Pour utiliser le ItemArray propriété, place null dans la position de la colonne dans le tableau.To use the ItemArray property, place null in the column's position in the array. Pour plus d’informations, consultez le ItemArray propriété de la DataRow classe.For more information, see the ItemArray property of the DataRow class.

Si le type de la colonne est SqlInt16 ou SqlInt32, AutoIncrement ne fonctionnera pas.If the type of the column is SqlInt16 or SqlInt32, AutoIncrement will not work. Utilisez à la place Int16 ou Int32.Use Int16 or Int32 instead.

Si le type de la colonne est SqlInt64 ou SqlDecimal, AutoIncrement fonctionnera uniquement partiellement.If the type of the column is SqlInt64 or SqlDecimal, AutoIncrement will only partially work. Utilisez à la place Int64 ou décimal.Use Int64 or Decimal instead.

Lorsque le AutoIncrementStep valeur est ajoutée à la valeur actuelle, la vérification de dépassement de capacité est supprimée.When the AutoIncrementStep value is added to the current value, the overflow check is suppressed.

S’applique à

Voir aussi