DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

在集合中的指定索引處插入資料行。

public:
 virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);

public virtual void Insert (int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);

abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unit

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

參數

columnIndex

Int32

要插入指定資料行之以零起始的索引。

dataGridViewColumn

DataGridViewColumn

要插入的 DataGridViewColumn。

例外狀況

ArgumentNullException

dataGridViewColumn 為 null。

InvalidOperationException

相關聯的 DataGridView 控制項正在執行下列其中一個動作，暫時阻止加入新的資料行：

• 選取控制項中的所有儲存格。

• 清除選取範圍。

• 更新資料行 DisplayIndex 屬性值。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-或-

dataGridViewColumn 已經屬於 DataGridView 控制項。

-或-

dataGridViewColumn SortMode 屬性值為 Automatic，而 SelectionMode 屬性值為 FullColumnSelect 或 ColumnHeaderSelect。 使用控制項 ISupportInitialize.BeginInit() 和 ISupportInitialize.EndInit() 方法，暫時設定衝突的屬性值。

-或-

dataGridViewColumn InheritedAutoSizeMode 屬性值為 ColumnHeader，而 ColumnHeadersVisible 屬性值為 false。

-或-

dataGridViewColumn 具有 InheritedAutoSizeMode 屬性值 Fill 和 Frozen 屬性值 true。

-或-

dataGridViewColumn 具有的 DisplayIndex 和 Frozen 屬性值，會將其顯示在一組具有相反 Frozen 屬性值的相鄰資料行之間。

-或-

DataGridView 控制項至少包含一個資料列，且 dataGridViewColumn 具有 CellType 屬性值 null。

範例

下列程式碼範例說明此方法的使用方式。 如需詳細資訊，請參閱如何：將未系結資料行新增至 Data-Bound Windows Forms DataGridView 控制項。

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(0, buttonColumn);
}

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(0, buttonColumn)

End Sub

另請參閱

• DataGridView
• DataGridViewColumn