DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 方法

定义

在集合中的给定索引处插入列。

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

例外

dataGridViewColumnnull

关联的 DataGridView 控件正在执行以下操作之一,该操作暂时禁止添加新列:

  • 选择控件中的所有单元格。

  • 清除所选内容。

  • 更新列 DisplayIndex 属性值。

- 或 -

正在从以下 DataGridView 事件之一的处理程序调用此方法:

- 或 -

dataGridViewColumn 已属于 DataGridView 控件。

- 或 -

dataGridViewColumn SortMode 属性值为 AutomaticSelectionMode 属性值为 FullColumnSelectColumnHeaderSelect。 使用该控件的 ISupportInitialize.BeginInit()ISupportInitialize.EndInit() 方法可暂时设置冲突的属性值。

- 或 -

dataGridViewColumn InheritedAutoSizeMode 属性值为 ColumnHeaderColumnHeadersVisible 属性值为 false

- 或 -

dataGridViewColumnInheritedAutoSizeMode 属性值为 FillFrozen 属性值为 true

- 或 -

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

- 或 -

DataGridView 控件至少包含一行,且 dataGridViewColumnCellType 的属性值为 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

适用于

另请参阅