다음을 통해 공유


DataColumn.AutoIncrement 속성

정의

테이블에 추가되는 새 행의 열 값이 자동으로 증가되는지 여부를 나타내는 값을 가져오거나 설정합니다.

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

속성 값

열 값이 자동으로 증가되면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

특성

예외

열이 계산 열인 경우

예제

다음 예제에서는 , AutoIncrementSeedAutoIncrementStep 속성을 설정합니다AutoIncrement.

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

설명

이 속성을 설정할 DataType 때 이 열의 형식이 Int16, Int32 또는 Int64가 아닌 경우 속성은 Int32로 강제 변환됩니다. 계산 열인 경우 예외가 생성됩니다. 속성이 Expression 설정됩니다. 증가된 값은 열 컬렉션에 추가할 때 이 열에 대한 행의 값이 기본값과 같은 경우에만 사용됩니다.

클래스의 속성을 사용하여 ItemArray 값 배열을 DataRow 전달하여 새 행을 만들 수 있습니다. 값이 자동으로 생성되기 때문에 가 로 설정된 trueAutoIncrement 에 대한 잠재적인 문제입니다. 속성을 사용 ItemArray 하려면 배열의 열 위치에 배치 null 합니다. 자세한 내용은 DataRow 클래스의 ItemArray 속성을 참조하세요.

열 형식이 또는 SqlInt32AutoIncrementSqlInt16 면 작동하지 않습니다. 대신 Int16 또는 Int32를 사용합니다.

열의 형식이 또는 SqlDecimalAutoIncrementSqlInt64 면 부분적으로만 작동합니다. 대신 Int64 또는 Decimal을 사용합니다.

값이 AutoIncrementStep 현재 값에 추가되면 오버플로 검사 표시되지 않습니다.

적용 대상

추가 정보