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
[<System.Data.DataSysDescription("DataColumnAutoIncrementDescr")>]
member this.AutoIncrement : bool with get, set
Public Property AutoIncrement As Boolean

속성 값

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 , 및 속성을 설정 합니다 AutoIncrementSeed 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

설명

이 속성을 설정할 때이 열의 형식이 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. 증가 된 값은이 열에 대 한 행의 값이 columns 컬렉션에 추가 될 때 기본값과 같은 경우에만 사용 됩니다.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.

클래스의 속성을 사용 하 여 새 행을 만들고 ItemArray DataRow 값의 배열을 전달할 수 있습니다.You can create a new row using the ItemArray property of the DataRow class and passing in an array of values. 이는 AutoIncrement true 값이 자동으로 생성 되기 때문에이로 설정 된 열에 대 한 잠재적인 문제입니다.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. 자세한 내용은 ItemArray 클래스의 속성을 참조 하세요 DataRow .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 또는 Decimal을 사용 하십시오.Use Int64 or Decimal instead.

값을 AutoIncrementStep 현재 값에 추가 하면 오버플로 검사가 억제 됩니다.When the AutoIncrementStep value is added to the current value, the overflow check is suppressed.

적용 대상

추가 정보