DataGridViewColumnCollection.Insert メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewColumnCollection.Insert メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コレクション内の指定したインデックスに列を挿入します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Insert
 ( _
    columnIndex As Integer, _
    dataGridViewColumn As DataGridViewColumn _
)

Visual Basic (使用法)

Dim instance As DataGridViewColumnCollection
Dim columnIndex As Integer
Dim dataGridViewColumn As DataGridViewColumn

instance.Insert(columnIndex, dataGridViewColumn)

C#

public virtual void Insert (
    int columnIndex,
    DataGridViewColumn dataGridViewColumn
)

C++

public:
virtual void Insert (
    int columnIndex, 
    DataGridViewColumn^ dataGridViewColumn
)

J#

public void Insert (
    int columnIndex, 
    DataGridViewColumn dataGridViewColumn
)

JScript

public function Insert (
    columnIndex : int, 
    dataGridViewColumn : DataGridViewColumn
)

パラメータ

columnIndex

指定した列を挿入する位置を示す 0 から始まるインデックス。

dataGridViewColumn

挿入する DataGridViewColumn。

例外

例外の種類	条件
ArgumentNullException	dataGridViewColumn が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	関連付けられた DataGridView コントロールによって次のいずれかのアクションが実行されているため、一時的に新しい列が追加できない状態にあります。 コントロールのすべてのセルを選択している。 選択範囲をクリアしている。 列の DisplayIndex プロパティ値を更新している。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。 CellEnter CellLeave CellValidating CellValidated RowEnter RowLeave RowValidated RowValidating または dataGridViewColumn は既に DataGridView コントロールに属しています。 または dataGridViewColumn SortMode プロパティの値が Automatic で、なおかつ、DataGridView.SelectionMode プロパティの値が FullColumnSelect または ColumnHeaderSelect です。競合するプロパティ値を一時的に設定するには、コントロールの System.ComponentModel.ISupportInitialize.BeginInit メソッドと System.ComponentModel.ISupportInitialize.EndInit メソッドを使用します。 または dataGridViewColumn InheritedAutoSizeMode プロパティの値が ColumnHeader で、なおかつ、DataGridView.ColumnHeadersVisible プロパティの値が false です。 または dataGridViewColumn の InheritedAutoSizeMode プロパティの値が Fill で、なおかつ、Frozen プロパティの値が true です。 または 逆の Frozen プロパティ値を持つ列と隣接してしまうような DisplayIndex プロパティ値と Frozen プロパティ値が、dataGridViewColumn に設定されています。 または DataGridView コントロールに、少なくとも 1 つの行が存在し、なおかつ、dataGridViewColumn の CellType プロパティの値が null 参照 (Visual Basic では Nothing) です。

使用例

このメソッドの使用方法を次のコード例に示します。詳細については、「方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する」を参照してください。

Visual Basic

Private Sub CreateUnboundButtonColumn()

    ' Initialize the button column.
    Dim buttonColumn As New
 DataGridViewButtonColumn

    With buttonColumn
        .HeaderText = "Details"
        .Name = "Details"
        .Text = "View Details"

        ' Use the Text property for the button text for all cells rather
        ' than using each cell's value as the text for its own button.
        .UseColumnTextForButtonValue = True
    End With

    ' Add the button column to the control.
    dataGridView1.Columns.Insert(1, buttonColumn)

End Sub

C#

private void CreateUnboundButtonColumn()
{
    // Initialize the button column.
    DataGridViewButtonColumn buttonColumn =
        new DataGridViewButtonColumn();
    buttonColumn.Name = "Details";
    buttonColumn.HeaderText = "Details";
    buttonColumn.Text = "View Details";

    // Use the Text property for the button text for all cells rather
    // than using each cell's value as the text for its own button.
    buttonColumn.UseColumnTextForButtonValue = true;

    // Add the button column to the control.
    dataGridView1.Columns.Insert(1, buttonColumn);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewColumnCollection クラス
DataGridViewColumnCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス