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