DataGridViewColumnCollection.Remove Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rimuove una colonna dalla raccolta.

Overload

Nome	Descrizione
Remove(String)	Rimuove la colonna con il nome specificato dall'insieme.
Remove(DataGridViewColumn)	Rimuove la colonna specificata dalla raccolta.

Remove(String)

Origine:

DataGridViewColumnCollection.cs

Rimuove la colonna con il nome specificato dall'insieme.

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

ArgumentException

columnName non corrisponde al nome di una colonna nella raccolta.

ArgumentNullException

columnName è null.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di 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 seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

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 di Windows Form.

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

• DataGridView
• DataBindingComplete
• DataGridViewColumn
• Name

Remove(DataGridViewColumn)

Origine:

DataGridViewColumnCollection.cs

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

ArgumentException

dataGridViewColumn non è presente nella raccolta.

ArgumentNullException

dataGridViewColumn è null.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di 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 seguenti DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

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

• DataGridView
• DataBindingComplete
• DataGridViewColumn