DataGridViewColumnCollection.Remove Metodo

Definizione

Rimuove una colonna dall'insieme.

Overload

Remove(String)

Rimuove dall'insieme la colonna con il nome specificato.

Remove(DataGridViewColumn)

Rimuove la colonna specificata dalla raccolta.

Remove(String)

Rimuove dall'insieme la colonna con il nome specificato.

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)

Parametri

columnName
String

Nome della colonna da eliminare.

Eccezioni

columnName non corrisponde al nome di una colonna nell'insieme.

columnName è null.

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere nuove colonne:

  • Selezione di tutte le celle nel controllo.

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

-oppure-

Questo metodo viene chiamato da un gestore per uno degli eventi di DataGridView seguenti:

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo metodo. Per altre informazioni, vedere Procedura: Rimuovere colonne generate automaticamente da un controllo 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

Commenti

Il nome di una colonna è indicato dalla DataGridViewColumn.Name proprietà .

Per rimuovere una colonna generata automaticamente quando si esegue il binding a un'origine dati, chiamare questo metodo in un DataGridView.DataBindingComplete gestore eventi.

Vedi anche

Si applica a

Remove(DataGridViewColumn)

Rimuove la colonna specificata dalla raccolta.

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)

Parametri

dataGridViewColumn
DataGridViewColumn

Colonna da eliminare.

Eccezioni

dataGridViewColumn non è nella raccolta.

dataGridViewColumn è null.

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere nuove colonne:

  • Selezione di tutte le celle nel controllo.

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

-oppure-

Questo metodo viene chiamato da un gestore per uno degli eventi di DataGridView seguenti:

Commenti

Per rimuovere una colonna generata automaticamente quando si esegue il binding a un'origine dati, chiamare questo metodo in un DataGridView.DataBindingComplete gestore eventi.

Vedi anche

Si applica a