DataGridViewColumnCollection.Remove Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Usuwa kolumnę z kolekcji.

Przeciążenia

Remove(String)

Usuwa kolumnę o określonej nazwie z kolekcji.
Remove(DataGridViewColumn)

Usuwa określoną kolumnę z kolekcji.

Remove(String)

Usuwa kolumnę o określonej nazwie z kolekcji.

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)

Parametry

columnName
String

Nazwa kolumny do usunięcia.

Wyjątki

ArgumentException

columnName nie jest zgodna z nazwą żadnej kolumny w kolekcji.

ArgumentNullException

columnName to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych kolumn:

  • Zaznaczanie wszystkich komórek w kontrolce.

  • Wyczyszczenie zaznaczenia.

  • Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub-

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

Przykłady

Poniższy przykład kodu ilustruje użycie tej metody. Aby uzyskać więcej informacji, zobacz How to: Remove Autogenerated Columns from a Windows Forms DataGridView Control (Instrukcje: usuwanie automatycznie wygenerowanych kolumn z kontrolki DataGridView) Windows Forms.

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

Uwagi

Nazwa kolumny jest wskazywana przez DataGridViewColumn.Name właściwość .

Aby usunąć kolumnę, która jest generowana automatycznie podczas wiązania ze źródłem danych, wywołaj tę metodę w procedurze obsługi zdarzeń DataGridView.DataBindingComplete .

Zobacz też

Dotyczy

Remove(DataGridViewColumn)

Usuwa określoną kolumnę z kolekcji.

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)

Parametry

dataGridViewColumn
DataGridViewColumn

Kolumna do usunięcia.

Wyjątki

ArgumentException

dataGridViewColumn nie znajduje się w kolekcji.

ArgumentNullException

dataGridViewColumn to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych kolumn:

  • Zaznaczanie wszystkich komórek w kontrolce.

  • Wyczyszczenie zaznaczenia.

  • Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub-

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

Uwagi

Aby usunąć kolumnę, która jest generowana automatycznie podczas wiązania ze źródłem danych, wywołaj tę metodę w procedurze obsługi zdarzeń DataGridView.DataBindingComplete .

Zobacz też

Dotyczy