DataGridViewColumnCollection.Remove DataGridViewColumnCollection.Remove DataGridViewColumnCollection.Remove DataGridViewColumnCollection.Remove Method

Определение

Удаляет столбец из коллекции.Removes a column from the collection.

Перегрузки

Remove(String) Remove(String) Remove(String) Remove(String)

Удаляет из коллекции столбец с указанным именем.Removes the column with the specified name from the collection.

Remove(DataGridViewColumn) Remove(DataGridViewColumn) Remove(DataGridViewColumn)

Удаляет указанный столбец из коллекции.Removes the specified column from the collection.

Remove(String) Remove(String) Remove(String) Remove(String)

Удаляет из коллекции столбец с указанным именем.Removes the column with the specified name from the collection.

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 String String String

Имя удаляемого столбца.The name of the column to delete.

Исключения

Параметр columnName не совпадает с именем ни одного из столбцов в коллекции.columnName does not match the name of any column in the collection.

Свойство columnName имеет значение null.columnName is null.

Сопоставленный элемент управления DataGridView выполняет одно из следующих действий, временно блокирующих добавление новых столбцов:The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: – выбор всех ячеек элемента управления;- Selecting all cells in the control.

– отмена выбора.- Clearing the selection.

– обновление значений свойств столбца DisplayIndex.- Updating column DisplayIndex property values.

- или --or- Этот метод вызывается из обработчика одного из следующих событий элемента управления DataGridView:This method is being called from a handler for one of the following DataGridView events:

Примеры

В следующем примере кода показано использование этого метода.The following code example illustrates the use of this method. Дополнительные сведения см. в разделе Практическое руководство. Удалить автоматически сформированные столбцы из элемента управленияWindows Forms DataGridView.For more information, see How to: Remove Autogenerated Columns from a Windows Forms DataGridView Control.

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 свойством.The name of a column is indicated by the DataGridViewColumn.Name property.

Чтобы удалить столбец, автоматически формируемый при привязке к источнику данных, вызовите этот метод в DataGridView.DataBindingComplete обработчике событий.To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

Дополнительно

Remove(DataGridViewColumn) Remove(DataGridViewColumn) Remove(DataGridViewColumn)

Удаляет указанный столбец из коллекции.Removes the specified column from the collection.

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

Параметры

dataGridViewColumn
DataGridViewColumn DataGridViewColumn DataGridViewColumn DataGridViewColumn

Удаляемый столбец.The column to delete.

Исключения

Столбец dataGridViewColumn отсутствует в коллекции.dataGridViewColumn is not in the collection.

Свойство dataGridViewColumn имеет значение null.dataGridViewColumn is null.

Сопоставленный элемент управления DataGridView выполняет одно из следующих действий, временно блокирующих добавление новых столбцов:The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: – выбор всех ячеек элемента управления;- Selecting all cells in the control.

– отмена выбора.- Clearing the selection.

– обновление значений свойств столбца DisplayIndex.- Updating column DisplayIndex property values.

-или--or- Этот метод вызывается из обработчика одного из следующих событий элемента управления DataGridView:This method is being called from a handler for one of the following DataGridView events:

Комментарии

Чтобы удалить столбец, автоматически формируемый при привязке к источнику данных, вызовите этот метод в DataGridView.DataBindingComplete обработчике событий.To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

Дополнительно

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