DataGridViewColumnCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta una raccolta di oggetti DataGridViewColumn in un controllo DataGridView.

public ref class DataGridViewColumnCollection : System::Windows::Forms::BaseCollection, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class DataGridViewColumnCollection : System.Windows.Forms.BaseCollection, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList

Ereditarietà

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Attributi

ListBindableAttribute

Implementazioni

ICollection IEnumerable IList

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo.

private DataGridView dataGridView1 = new DataGridView();

private void AddColorColumn()
{
    DataGridViewComboBoxColumn comboBoxColumn =
        new DataGridViewComboBoxColumn();
    comboBoxColumn.Items.AddRange(
        Color.Red, Color.Yellow, Color.Green, Color.Blue);
    comboBoxColumn.ValueType = typeof(Color);
    dataGridView1.Columns.Add(comboBoxColumn);
    dataGridView1.EditingControlShowing +=
        new DataGridViewEditingControlShowingEventHandler(
        dataGridView1_EditingControlShowing);
}

private void dataGridView1_EditingControlShowing(object sender,
    DataGridViewEditingControlShowingEventArgs e)
{
    ComboBox combo = e.Control as ComboBox;
    if (combo != null)
    {
        // Remove an existing event-handler, if present, to avoid 
        // adding multiple handlers when the editing control is reused.
        combo.SelectedIndexChanged -=
            new EventHandler(ComboBox_SelectedIndexChanged);

        // Add the event handler. 
        combo.SelectedIndexChanged +=
            new EventHandler(ComboBox_SelectedIndexChanged);
    }
}

private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}

Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

Commenti

È possibile recuperare un'istanza di questa classe tramite la Columns proprietà del DataGridView controllo . L'insieme mantiene un riferimento al controllo tramite la DataGridView proprietà .

Costruttori

DataGridViewColumnCollection(DataGridView)

Inizializza una nuova istanza della classe DataGridViewColumnCollection per l'insieme DataGridView specificato.

Proprietà

Count	Ottiene il numero totale di elementi nella raccolta. (Ereditato da BaseCollection)
DataGridView	Ottiene l'oggetto DataGridView dell'insieme sul quale vengono eseguite le operazioni relative alle colonne.
IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura. (Ereditato da BaseCollection)
IsSynchronized	Ottiene un valore che indica se l'accesso all'interfaccia ICollection è sincronizzato. (Ereditato da BaseCollection)
Item[Int32]	Ottiene o imposta la colonna nell'insieme in corrispondenza dell'indice specificato.
Item[String]	Ottiene o imposta la colonna con il nome specificato nell'insieme.
List	Ottiene l'elenco degli elementi contenuti nell'istanza di BaseCollection.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a BaseCollection. (Ereditato da BaseCollection)

Metodi

Add(DataGridViewColumn)	Aggiunge all'insieme la colonna specificata.
Add(String, String)	Aggiunge all'insieme un oggetto DataGridViewTextBoxColumn con il nome e il testo di intestazione della colonna specificati.
AddRange(DataGridViewColumn[])	Aggiunge all'insieme un intervallo di colonne.
Clear()	Cancella la raccolta.
Contains(DataGridViewColumn)	Stabilisce se l'insieme contiene la colonna specificata.
Contains(String)	Stabilisce se l'insieme contiene la colonna cui fa riferimento il nome specificato.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto Array unidimensionale corrente nell'oggetto Array unidimensionale specificato a partire dall'indice Array di destinazione indicato. (Ereditato da BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copia gli elementi dall'insieme nella matrice specificata.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetColumnCount(DataGridViewElementStates)	Restituisce il numero di colonne che risponde ai requisiti di filtro specificati.
GetColumnsWidth(DataGridViewElementStates)	Restituisce la larghezza, in pixel, necessaria per visualizzare tutte le colonne che rispondono ai requisiti di filtro specificati.
GetEnumerator()	Ottiene l'oggetto che consente di scorrere i membri dell'insieme. (Ereditato da BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione e l'esclusione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Restituisce l'ultima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati.
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ottiene la prima colonna dopo la colonna specificata in ordine di visualizzazione che risponde ai requisiti di filtro specificati.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ottiene l'ultima colonna prima della colonna specificata in ordine di visualizzazione che risponde ai requisiti di filtro specificati.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(DataGridViewColumn)	Ottiene l'indice dell'oggetto DataGridViewColumn specificato nell'insieme.
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Inserisce una colonna nell'insieme in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Genera l'evento CollectionChanged.
Remove(DataGridViewColumn)	Rimuove la colonna specificata dalla raccolta.
Remove(String)	Rimuove dall'insieme la colonna con il nome specificato.
RemoveAt(Int32)	Rimuove dall'insieme la colonna in corrispondenza dell'indice specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

CollectionChanged

Si verifica quando viene modificata la raccolta.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Consente di copiare l'intero contenuto dell'insieme in una Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.
ICollection.Count	Ottiene il numero di elementi nella raccolta.
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato.
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.
IEnumerable.GetEnumerator()	Restituisce un enumeratore che consente di scorrere la raccolta.
IList.Add(Object)	Aggiunge un oggetto alla fine della raccolta.
IList.Clear()	Rimuove tutti gli elementi dalla raccolta.
IList.Contains(Object)	Determina se un oggetto è incluso nell'insieme.
IList.IndexOf(Object)	Determina l'indice di un elemento specifico dell'insieme.
IList.Insert(Int32, Object)	Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se la dimensione della raccolta è fissa.
IList.IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura.
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove l'occorrenza dell'oggetto specificato dalla raccolta.
IList.RemoveAt(Int32)	Rimuove dall'insieme l'elemento con l'indice specificato.

Metodi di estensione

Vedi anche

• DataGridView
• Columns
• DataGridViewColumn