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.

-или-

Свойство InheritedAutoSizeMode столбца dataGridViewColumn имеет значение Fill, а свойство Frozen — значение true.

-или-

В столбце dataGridViewColumn заданы такие значения свойств DisplayIndex и Frozen, в результате которых столбец будет отображаться среди набора смежных столбцов с противоположным значением свойства Frozen.

-или-

Элемент управления DataGridView содержит по крайней мере одну строку, а столбец dataGridViewColumn имеет свойство CellType со значением null.

Примеры

В следующем примере кода показано использование этого метода. Дополнительные сведения см. в статье How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control.

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