DataColumn.AutoIncrement 속성

정의

테이블에 추가되는 새 행의 열 값이 자동으로 증가되는지 여부를 나타내는 값을 가져오거나 설정합니다.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); };
public bool AutoIncrement { get; set; }
[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }
member this.AutoIncrement : bool with get, set
Public Property AutoIncrement As Boolean

속성 값

열 값이 자동으로 증가되면 true이고, 그렇지 않으면 false입니다.true if the value of the column increments automatically; otherwise, false. 기본값은 false입니다.The default is false.

특성

예외

열이 계산 열인 경우The column is a computed column.

예제

다음 예에서는 AutoIncrement, AutoIncrementSeedAutoIncrementStep 속성을 설정 합니다.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

설명

이 속성을 설정할 때이 열의 형식이 Int16, Int32 또는 Int64가 아니면 DataType 속성이 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. 계산된 열이 있으면 예외가 생성 됩니다.An exception is generated if this is a computed column. Expression 속성이 설정 되어 있습니다.The Expression property is set. 증가 된 값을 열 컬렉션에 추가 하는 경우이 열에 대 한 행의 값은 기본값을 사용 하는 경우에 사용 됩니다.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.

DataRow 클래스의 ItemArray 속성을 사용 하 고 값 배열을 전달 하 여 새 행을 만들 수 있습니다.You can create a new row using the ItemArray property of the DataRow class and passing in an array of values. 이는 해당 값이 자동으로 생성 되기 때문에 AutoIncrementtrue로 설정 된 열에 대 한 잠재적인 문제입니다.This is a potential problem for a column with its AutoIncrement set to true, because its value is generated automatically. ItemArray 속성을 사용 하려면 배열의 열 위치에 null을 배치 합니다.To use the ItemArray property, place null in the column's position in the array. 자세한 내용은 DataRow 클래스의 ItemArray 속성을 참조 하세요.For more information, see the ItemArray property of the DataRow class.

열 유형이 SqlInt16 또는 SqlInt32이면 AutoIncrement 작동 하지 않습니다.If the type of the column is SqlInt16 or SqlInt32, AutoIncrement will not work. Int16 또는 Int32를 대신 사용 합니다.Use Int16 or Int32 instead.

열 유형이 SqlInt64 또는 SqlDecimal인 경우에는 AutoIncrement 일부만 작동 합니다.If the type of the column is SqlInt64 or SqlDecimal, AutoIncrement will only partially work. Int64 또는 10 진수를 대신 사용 합니다.Use Int64 or Decimal instead.

AutoIncrementStep 값이 현재 값에 추가 되 면 오버플로 검사가 표시 되지 않습니다.When the AutoIncrementStep value is added to the current value, the overflow check is suppressed.

적용 대상

추가 정보