영어로 읽기

다음을 통해 공유


DataColumn.AutoIncrement 속성

정의

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

public bool AutoIncrement { get; set; }
[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }

속성 값

열 값이 자동으로 증가되면 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);
}

설명

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

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

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

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

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

적용 대상

제품 버전
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

추가 정보