DataGridViewColumnCollection.Remove Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Remove uma coluna da coleção.
Sobrecargas
| Name | Description |
|---|---|
| Remove(String) |
Remove a coluna com o nome especificado da coleção. |
| Remove(DataGridViewColumn) |
Remove a coluna especificada da coleção. |
Remove(String)
Remove a coluna com o nome especificado da coleção.
public:
virtual void Remove(System::String ^ columnName);public virtual void Remove(string columnName);abstract member Remove : string -> unit
override this.Remove : string -> unitPublic Overridable Sub Remove (columnName As String)Parâmetros
- columnName
- String
O nome da coluna a eliminar.
Exceções
columnName não corresponde ao nome de nenhuma coluna da coleção.
columnName é null.
O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:
Selecionar todas as células no controlo.
A limpar a seleção.
Atualizar os valores das propriedades das colunas DisplayIndex .
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
Exemplos
O seguinte exemplo de código ilustra a utilização deste método. Para mais informações, consulte Como: Remover Colunas Geradas Automaticamente de um Controlo 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
Observações
O nome de uma coluna é indicado pela DataGridViewColumn.Name propriedade.
Para remover uma coluna que é gerada automaticamente ao ligar a uma fonte de dados, chame este método num DataGridView.DataBindingComplete gestor de eventos.
Ver também
Aplica-se a
Remove(DataGridViewColumn)
Remove a coluna especificada da coleção.
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 -> unitPublic Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)Parâmetros
- dataGridViewColumn
- DataGridViewColumn
A coluna a apagar.
Exceções
dataGridViewColumn não está na coleção.
dataGridViewColumn é null.
O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:
Selecionar todas as células no controlo.
A limpar a seleção.
Atualizar os valores das propriedades das colunas DisplayIndex .
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
Observações
Para remover uma coluna que é gerada automaticamente ao ligar a uma fonte de dados, chame este método num DataGridView.DataBindingComplete gestor de eventos.
