DataGridViewColumnCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewColumnCollection.cs

Rappresenta una raccolta di DataGridViewColumn oggetti in un DataGridView controllo .

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 gestisce un riferimento al controllo tramite la DataGridView proprietà .

Costruttori

Nome	Descrizione
DataGridViewColumnCollection(DataGridView)	Inizializza una nuova istanza della DataGridViewColumnCollection classe per l'oggetto specificato DataGridView.

Proprietà

Nome	Descrizione
Count	Ottiene il numero totale di elementi nella raccolta. (Ereditato da BaseCollection)
DataGridView	Ottiene l'oggetto DataGridView su cui la raccolta esegue operazioni correlate alle colonne.
IsReadOnly	Ottiene un valore che indica se l'insieme è di sola lettura. (Ereditato da BaseCollection)
IsSynchronized	Ottiene un valore che indica se l'accesso ICollection a è sincronizzato. (Ereditato da BaseCollection)
Item[Int32]	Ottiene o imposta la colonna in corrispondenza dell'indice specificato nell'insieme.
Item[String]	Ottiene o imposta la colonna del nome specificato nella raccolta.
List	Ottiene l'elenco di elementi contenuti nell'istanza BaseCollection di .
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al BaseCollection. (Ereditato da BaseCollection)

Metodi

Nome	Descrizione
Add(DataGridViewColumn)	Aggiunge la colonna specificata all'insieme.
Add(String, String)	Aggiunge un oggetto DataGridViewTextBoxColumn con il nome della colonna e il testo dell'intestazione di colonna specificati all'insieme.
AddRange(DataGridViewColumn[])	Aggiunge un intervallo di colonne all'insieme.
Clear()	Cancella la raccolta.
Contains(DataGridViewColumn)	Determina se la raccolta contiene la colonna specificata.
Contains(String)	Determina se la raccolta contiene la colonna a cui fa riferimento il nome specificato.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto unidimensionale corrente nell'oggetto unidimensionale ArrayArray specificato a partire dall'indice di destinazione Array specificato. (Ereditato da BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copia gli elementi dall'insieme alla matrice specificata.
GetColumnCount(DataGridViewElementStates)	Restituisce il numero di colonne che soddisfano i requisiti di filtro specificati.
GetColumnsWidth(DataGridViewElementStates)	Restituisce la larghezza, in pixel, necessaria per visualizzare tutte le colonne che soddisfano i requisiti di filtro specificati.
GetEnumerator()	Ottiene l'oggetto che consente di scorrere i membri dell'insieme. (Ereditato da BaseCollection)
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro di inclusione e filtro di esclusione specificati.
GetFirstColumn(DataGridViewElementStates)	Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro inclusione specificati.
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Restituisce l'ultima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro specificati.
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ottiene la prima colonna dopo la colonna specificata nell'ordine di visualizzazione che soddisfa i requisiti di filtro specificati.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Ottiene l'ultima colonna precedente alla colonna specificata nell'ordine di visualizzazione che soddisfa i requisiti di filtro specificati.
IndexOf(DataGridViewColumn)	Ottiene l'indice dell'oggetto specificato DataGridViewColumn nell'insieme.
Insert(Int32, DataGridViewColumn)	Inserisce una colonna in corrispondenza dell'indice specificato nell'insieme.
OnCollectionChanged(CollectionChangeEventArgs)	Genera l'evento CollectionChanged.
Remove(DataGridViewColumn)	Rimuove la colonna specificata dalla raccolta.
Remove(String)	Rimuove la colonna con il nome specificato dall'insieme.
RemoveAt(Int32)	Rimuove la colonna in corrispondenza dell'indice specificato nell'insieme.

Eventi

Nome	Descrizione
CollectionChanged	Si verifica quando la raccolta viene modificata.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICollection.CopyTo(Array, Int32)	Copia l'intero contenuto dell'insieme in un oggetto unidimensionale Arraycompatibile, 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 utilizzato per sincronizzare l'accesso all'insieme.
IEnumerable.GetEnumerator()	Restituisce un enumeratore che scorre l'insieme.
IList.Add(Object)	Aggiunge un oggetto alla fine dell'insieme.
IList.Clear()	Rimuove tutti gli elementi dalla raccolta.
IList.Contains(Object)	Determina se un oggetto si trova nell'insieme.
IList.IndexOf(Object)	Determina l'indice di un elemento specifico nell'insieme.
IList.Insert(Int32, Object)	Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se la raccolta ha una dimensione fissa.
IList.IsReadOnly	Ottiene un valore che indica se l'insieme è di sola lettura.
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove la prima occorrenza dell'oggetto specificato dall'insieme.
IList.RemoveAt(Int32)	Rimuove l'elemento con l'indice specificato dall'insieme.

Vedi anche

• DataGridView
• Columns
• DataGridViewColumn