DataColumn.AutoIncrement プロパティ

このテーブルに追加される新しい行でこの列の値を自動的にインクリメントするかどうかを示す値を取得または設定します。

Public Property AutoIncrement As Boolean
[C#]
public bool AutoIncrement {get; set;}
[C++]
public: __property bool get_AutoIncrement();public: __property void set_AutoIncrement(bool);
[JScript]
public function get AutoIncrement() : Boolean;public function set AutoIncrement(Boolean);

プロパティ値

この列の値を自動的にインクリメントする場合は true 。それ以外の場合は false 。既定値は false です。

例外

例外の種類	条件
ArgumentException	この列は計算列です。

解説

この列の型が Int16、Int32、または Int64 のいずれでもない場合にこのプロパティが設定されているときは、 DataType プロパティが強制的に Int32 に変更されます。この列が計算列である (つまり、 Expression プロパティが設定されている) 場合は、例外が生成されます。列コレクションにこの列が追加されたときにこの列の行の値が既定値と等しい場合だけ、インクリメントされた値が使用されます。

DataRow クラスの ItemArray プロパティを使用し、値の配列を渡して、新しい行を作成できます。ただし、 AutoIncrement が true に設定されている列では、値が自動的に生成されるため、このプロパティを使用すると問題が発生することがあります。このため、 ItemArray プロパティを使用するには、配列内のその列の位置に null 参照 (Visual Basic では Nothing) を指定してください。詳細については、 DataRow クラスの ItemArray プロパティのトピックを参照してください。

使用例

[Visual Basic, C#, C++] AutoIncrement 、 AutoIncrementSeed 、 AutoIncrementStep の各プロパティを設定する例を次に示します。

 
Private Sub AddAutoIncrementColumn()
    Dim myColumn As DataColumn = New DataColumn
    myColumn.DataType = System.Type.GetType("System.Int32")
    With MyColumn
       .AutoIncrement = True
       .AutoIncrementSeed = 1000
       .AutoIncrementStep = 10
    End With
    ' Add the column to a new DataTable.
    Dim myTable As DataTable
    myTable = New DataTable
    myTable.Columns.Add(myColumn)
 End Sub

[C#] 
private void AddAutoIncrementColumn(){
    DataColumn myColumn = new DataColumn();
    myColumn.DataType = System.Type.GetType("System.Int32");
    myColumn.AutoIncrement = true;
    myColumn.AutoIncrementSeed = 1000;
    myColumn.AutoIncrementStep = 10;
    // Add the column to a new DataTable.
    DataTable myTable = new DataTable("MyTable");
    myTable.Columns.Add(myColumn);
 }

[C++] 
private:
void AddAutoIncrementColumn(){
    DataColumn* myColumn = new DataColumn();
    myColumn->DataType = System::Type::GetType(S"System.Int32");
    myColumn->AutoIncrement = true;
    myColumn->AutoIncrementSeed = 1000;
    myColumn->AutoIncrementStep = 10;
    // Add the column to a new DataTable.
    DataTable* myTable = new DataTable(S"MyTable");
    myTable->Columns->Add(myColumn);
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataColumn クラス | DataColumn メンバ | System.Data 名前空間 | AutoIncrementSeed | AutoIncrementStep | Expression | ItemArray | NewRow