DataGridViewColumnCollection.Remove Methode

Definition

Entfernt eine Spalte aus der Auflistung.Removes a column from the collection.

Überlädt

Remove(String)

Entfernt die Spalte mit dem angegebenen Namen aus der Auflistung.Removes the column with the specified name from the collection.

Remove(DataGridViewColumn)

Entfernt die angegebene Spalte aus der Auflistung.Removes the specified column from the collection.

Remove(String)

Entfernt die Spalte mit dem angegebenen Namen aus der Auflistung.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)

Parameter

columnName
String

Der Name der zu löschenden Spalte.The name of the column to delete.

Ausnahmen

columnName stimmt nicht mit dem Namen einer der Spalten in der Auflistung überein.columnName does not match the name of any column in the collection.

columnName ist null.columnName is null.

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert:The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: – Auswählen aller Zellen im Steuerelement.- Selecting all cells in the control.

– Aufheben der Auswahl.- Clearing the selection.

– Aktualisieren der Eigenschaftswerte in Spalte DisplayIndex.- Updating column DisplayIndex property values.

- oder --or- Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:This method is being called from a handler for one of the following DataGridView events:

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung dieser Methode.The following code example illustrates the use of this method. Weitere Informationen finden Sie unter Vorgehens Weise: Entfernen von automatisch generierten Spalten aus einem Windows Forms DataGridView-SteuerElement.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

Hinweise

Der Name einer Spalte wird durch die DataGridViewColumn.Name-Eigenschaft angegeben.The name of a column is indicated by the DataGridViewColumn.Name property.

Um eine Spalte zu entfernen, die beim Binden an eine Datenquelle automatisch generiert wird, müssen Sie diese Methode in einem DataGridView.DataBindingComplete-Ereignishandler aufzurufen.To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

Siehe auch

Remove(DataGridViewColumn)

Entfernt die angegebene Spalte aus der Auflistung.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
Public Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)

Parameter

dataGridViewColumn
DataGridViewColumn

Die zu löschende Spalte.The column to delete.

Ausnahmen

dataGridViewColumn ist nicht in der Auflistung enthalten.dataGridViewColumn is not in the collection.

dataGridViewColumn ist null.dataGridViewColumn is null.

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert:The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: – Auswählen aller Zellen im Steuerelement.- Selecting all cells in the control.

– Aufheben der Auswahl.- Clearing the selection.

– Aktualisieren der Eigenschaftswerte in Spalte DisplayIndex.- Updating column DisplayIndex property values.

- oder --or- Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:This method is being called from a handler for one of the following DataGridView events:

Hinweise

Um eine Spalte zu entfernen, die beim Binden an eine Datenquelle automatisch generiert wird, müssen Sie diese Methode in einem DataGridView.DataBindingComplete-Ereignishandler aufzurufen.To remove a column that is automatically generated when binding to a data source, call this method in a DataGridView.DataBindingComplete event handler.

Siehe auch

Gilt für: