DataGridViewColumnCollection.Remove Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Entfernt eine Spalte aus der Auflistung.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 -> unitPublic Overridable Sub Remove (columnName As String)Parameter
- columnName
- String
Der Name der zu löschenden Spalte.
Ausnahmen
columnName stimmt nicht mit dem Namen einer Spalte in der Auflistung überein.
columnName ist null.
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Spalten hinzugefügt werden:
Markieren aller Zellen im Steuerelement.
Die Auswahl wird gelöscht.
Aktualisieren von Spalteneigenschaftswerten DisplayIndex .
- oder -
Diese Methode wird von einem Handler für eines der folgenden DataGridView Ereignisse aufgerufen:
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung dieser Methode. Weitere Informationen finden Sie unter 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.
Um eine Spalte zu entfernen, die beim Binden an eine Datenquelle automatisch generiert wird, rufen Sie diese Methode in einem DataGridView.DataBindingComplete Ereignishandler auf.
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 -> unitPublic Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)Parameter
- dataGridViewColumn
- DataGridViewColumn
Die zu löschende Spalte.
Ausnahmen
dataGridViewColumn ist nicht in der Auflistung enthalten.
dataGridViewColumn ist null.
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Spalten hinzugefügt werden:
Markieren aller Zellen im Steuerelement.
Die Auswahl wird gelöscht.
Aktualisieren von Spalteneigenschaftswerten DisplayIndex .
- oder -
Diese Methode wird von einem Handler für eines der folgenden DataGridView Ereignisse aufgerufen:
Hinweise
Um eine Spalte zu entfernen, die beim Binden an eine Datenquelle automatisch generiert wird, rufen Sie diese Methode in einem DataGridView.DataBindingComplete Ereignishandler auf.
