DataGridViewColumnCollection.Remove Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Удаляет столбец из коллекции.

Перегрузки

Имя	Описание
Remove(String)	Удаляет столбец с указанным именем из коллекции.
Remove(DataGridViewColumn)	Удаляет указанный столбец из коллекции.

Remove(String)

Исходный код:

DataGridViewColumnCollection.cs

Удаляет столбец с указанным именем из коллекции.

public:
 virtual void Remove(System::String ^ columnName);

public virtual void Remove(string columnName);

abstract member Remove : string -> unit
override this.Remove : string -> unit

Public Overridable Sub Remove (columnName As String)

Параметры

columnName

String

Имя столбца для удаления.

Исключения

ArgumentException

columnName не соответствует имени любого столбца в коллекции.

ArgumentNullException

columnName равно null.

InvalidOperationException

Связанный DataGridView элемент управления выполняет одно из следующих действий, которые временно препятствуют добавлению новых столбцов:

• Выбор всех ячеек в элементе управления.

• Очистка выделения.

• Обновление значений свойств столбца DisplayIndex .

–или–

Этот метод вызывается из обработчика для одного из следующих DataGridView событий:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

Примеры

В следующем примере кода показано использование этого метода. Дополнительные сведения см. в статье "Практическое руководство. Удаление автоматически созданных столбцов из элемента управления DataGridView в Windows Forms".

private void BindDataAndInitializeColumns()
{
    dataGridView1.AutoGenerateColumns = true;
    dataGridView1.DataSource = customersDataSet;
    dataGridView1.Columns.Remove("Fax");
    dataGridView1.Columns["CustomerID"].Visible = false;
}

Private Sub BindDataAndInitializeColumns()

    With dataGridView1
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .Columns.Remove("Fax")
        .Columns("CustomerID").Visible = False
    End With

End Sub

Комментарии

Имя столбца указывается свойством DataGridViewColumn.Name .

Чтобы удалить столбец, который автоматически создается при привязке к источнику данных, вызовите этот метод в обработчике DataGridView.DataBindingComplete событий.

См. также раздел

• DataGridView
• DataBindingComplete
• DataGridViewColumn
• Name

Remove(DataGridViewColumn)

Исходный код:

DataGridViewColumnCollection.cs

Удаляет указанный столбец из коллекции.

public:
 virtual void Remove(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);

public virtual void Remove(System.Windows.Forms.DataGridViewColumn dataGridViewColumn);

abstract member Remove : System.Windows.Forms.DataGridViewColumn -> unit
override this.Remove : System.Windows.Forms.DataGridViewColumn -> unit

Public Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)

Параметры

dataGridViewColumn

DataGridViewColumn

Столбец для удаления.

Исключения

ArgumentException

dataGridViewColumn не находится в коллекции.

ArgumentNullException

dataGridViewColumn равно null.

InvalidOperationException

Связанный DataGridView элемент управления выполняет одно из следующих действий, которые временно препятствуют добавлению новых столбцов:

• Выбор всех ячеек в элементе управления.

• Очистка выделения.

• Обновление значений свойств столбца DisplayIndex .

–или–

Этот метод вызывается из обработчика для одного из следующих DataGridView событий:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

Комментарии

Чтобы удалить столбец, который автоматически создается при привязке к источнику данных, вызовите этот метод в обработчике DataGridView.DataBindingComplete событий.

См. также раздел

• DataGridView
• DataBindingComplete
• DataGridViewColumn