DataColumn.AutoIncrement 속성
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
테이블에 추가되는 새 행의 열 값이 자동으로 증가되는지 여부를 나타내는 값을 가져오거나 설정합니다.
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
입니다.
- 특성
열이 계산 열인 경우
다음 예제에서는 , AutoIncrementSeed및 AutoIncrementStep 속성을 설정합니다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 전달하여 새 행을 만들 수 있습니다. 값이 자동으로 생성되기 때문에 가 로 설정된 true
열 AutoIncrement 에 대한 잠재적인 문제입니다. 속성을 사용 ItemArray 하려면 배열의 열 위치에 배치 null
합니다. 자세한 내용은 DataRow 클래스의 ItemArray 속성을 참조하세요.
열 형식이 또는 SqlInt32AutoIncrement 이 SqlInt16 면 작동하지 않습니다. 대신 Int16 또는 Int32를 사용합니다.
열의 형식이 또는 SqlDecimalAutoIncrement 이 SqlInt64 면 부분적으로만 작동합니다. 대신 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 |
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.