DataGridViewColumnCollection.Remove Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Quita una columna de la colección.

Sobrecargas

Remove(String)

Quita de la colección la columna con el nombre especificado.
Remove(DataGridViewColumn)

Quita de la colección la columna especificada.

Remove(String)

Quita de la colección la columna con el nombre especificado.

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)

Parámetros

columnName
String

Nombre de la columna que se va a eliminar.

Excepciones

ArgumentException

columnName no coincide con el nombre de ninguna columna de la colección.

ArgumentNullException

columnName es null.

InvalidOperationException

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas columnas:

  • Seleccionar todas las celdas del control.

  • Borrar la selección.

  • Actualizando los valores de propiedad de columna DisplayIndex .

o bien

Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este método. Para obtener más información, vea 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

Comentarios

El nombre de una columna se indica mediante la DataGridViewColumn.Name propiedad .

Para quitar una columna que se genera automáticamente al enlazar a un origen de datos, llame a este método en un DataGridView.DataBindingComplete controlador de eventos.

Consulte también

Se aplica a

Remove(DataGridViewColumn)

Quita de la colección la columna especificada.

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)

Parámetros

dataGridViewColumn
DataGridViewColumn

Columna que se va a eliminar.

Excepciones

ArgumentException

dataGridViewColumn no está en la colección.

ArgumentNullException

dataGridViewColumn es null.

InvalidOperationException

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas columnas:

  • Seleccionar todas las celdas del control.

  • Borrar la selección.

  • Actualizando los valores de propiedad de columna DisplayIndex .

o bien

Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:

Comentarios

Para quitar una columna que se genera automáticamente al enlazar a un origen de datos, llame a este método en un DataGridView.DataBindingComplete controlador de eventos.

Consulte también

Se aplica a