Freigeben über

DataGridViewColumnCollection.Remove Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Entfernt eine Spalte aus der Auflistung.

Überlädt

Remove(String)

Entfernt die Spalte mit dem angegebenen Namen aus der Auflistung.
Remove(DataGridViewColumn)

Entfernt die angegebene Spalte aus der Auflistung.

Remove(String)

Entfernt die Spalte mit dem angegebenen Namen aus der Auflistung.

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.

Ausnahmen

ArgumentException

columnName stimmt nicht mit dem Namen einer der Spalten in der Auflistung überein.

ArgumentNullException

columnName ist null.

InvalidOperationException

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert:

  • Auswählen aller Zellen im Steuerelement.

  • Die Auswahl wird gelöscht.

  • DisplayIndex Spalteneigenschaftenwerte werden aktualisiert.

- oder -

Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Methode veranschaulicht. Weitere Informationen finden Sie unter Vorgehensweise: Entfernen automatisch generierter Spalten aus einem Windows Forms DataGridView-Steuerelements.

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.

Um eine Spalte zu entfernen, die bei der Bindung an eine Datenquelle automatisch generiert wird, rufen Sie diese Methode in einem Ereignishandler auf DataGridView.DataBindingComplete .

Weitere Informationen

Gilt für:

Remove(DataGridViewColumn)

Entfernt die angegebene Spalte aus der Auflistung.

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.

Ausnahmen

ArgumentException

Das dataGridViewColumn-Objekt ist nicht in der Auflistung enthalten.

ArgumentNullException

dataGridViewColumn ist null.

InvalidOperationException

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert:

  • Auswählen aller Zellen im Steuerelement.

  • Die Auswahl wird gelöscht.

  • DisplayIndex Spalteneigenschaftenwerte werden aktualisiert.

- oder -

Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:

Hinweise

Um eine Spalte zu entfernen, die bei der Bindung an eine Datenquelle automatisch generiert wird, rufen Sie diese Methode in einem Ereignishandler auf DataGridView.DataBindingComplete .

Weitere Informationen

Gilt für: