DataGridViewColumnCollection.Remove Метод

Определение

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

Перегрузки

Remove(String)

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

Remove(DataGridViewColumn)

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

Remove(String)

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

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

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

Исключения

Параметр columnName не совпадает с именем ни одного из столбцов в коллекции.

columnName имеет значение null.

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

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

  • Очистка выделенного фрагмента.

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

-или-

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

Примеры

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

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 событий.

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

Применяется к

Remove(DataGridViewColumn)

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

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

Удаляемый столбец.

Исключения

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

dataGridViewColumn имеет значение null.

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

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

  • Очистка выделенного фрагмента.

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

-или-

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

Комментарии

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

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

Применяется к