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 控件。

- 或 -

dataGridViewColumnSortMode 属性值为 Automatic 和 SelectionMode 属性值为 FullColumnSelect 或 ColumnHeaderSelect。 使用该控件的 ISupportInitialize.BeginInit() 和 ISupportInitialize.EndInit() 方法可暂时设置冲突的属性值。

- 或 -

dataGridViewColumnInheritedAutoSizeMode 属性值为 ColumnHeader，ColumnHeadersVisible 属性值为 false。

- 或 -

dataGridViewColumn 的 InheritedAutoSizeMode 属性值为 Fill，Frozen 属性值为 true。

- 或 -

dataGridViewColumn 的 DisplayIndex 和 Frozen 属性值会在具有相反的 Frozen 属性值的一组相邻列中显示它。

- 或 -

DataGridView 控件至少包含一行，且 dataGridViewColumn 的 CellType 的属性值为 null。

示例

下面的代码示例演示了此方法的使用。 有关详细信息，请参阅如何：将未绑定列添加到 Data-Bound Windows 窗体 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