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
| 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 der Spalten in der Auflistung überein.
columnName ist null.
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 -> unitPublic Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)Parameter
- dataGridViewColumn
- DataGridViewColumn
Die zu löschende Spalte.
Ausnahmen
Das dataGridViewColumn-Objekt ist nicht in der Auflistung enthalten.
dataGridViewColumn ist null.
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 .
