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.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.

Attributs

Exceptions

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

Exemples

L’exemple suivant définit les AutoIncrementpropriétés AutoIncrementSeed, et AutoIncrementStep .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 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.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. La 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 de cette colonne, lorsqu’elle est ajoutée à la collection Columns, 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 à l' ItemArray aide de la DataRow propriété de la 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 AutoIncrement dont la truevaleur est, 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 la ItemArray propriété, placez null -la à 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 ItemArray la propriété de DataRow la classe.For more information, see the ItemArray property of the DataRow class.

Si le type de la colonne est SqlInt16 ou SqlInt32, AutoIncrement ne fonctionne 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 ne fonctionne que partiellement.If the type of the column is SqlInt64 or SqlDecimal, AutoIncrement will only partially work. Utilisez à la place Int64 ou Decimal.Use Int64 or Decimal instead.

Lorsque la 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