DataGridViewColumnCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa uma coleção de objetos DataGridViewColumn em um controle 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

Herança

Object

MarshalByRefObject

BaseCollection

DataGridViewColumnCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a seguir ilustra o uso desse 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

Comentários

Você pode recuperar uma instância dessa classe por meio da Columns propriedade do DataGridView controle . A coleção mantém uma referência ao controle por meio da DataGridView propriedade .

Construtores

DataGridViewColumnCollection(DataGridView)

Inicializa uma nova instância da classe DataGridViewColumnCollection para o DataGridView fornecido.

Propriedades

Count	Obtém o número total de elementos na coleção. (Herdado de BaseCollection)
DataGridView	Obtém o DataGridView no qual a coleção executa operações relacionadas à coluna.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura. (Herdado de BaseCollection)
IsSynchronized	Obtém um valor que indica se o acesso à ICollection é sincronizado. (Herdado de BaseCollection)
Item[Int32]	Obtém ou define a coluna no índice especificado na coleção.
Item[String]	Obtém ou define a coluna do nome especificado na coleção.
List	Obtém a lista de elementos contidos na instância BaseCollection.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao BaseCollection. (Herdado de BaseCollection)

Métodos

Add(DataGridViewColumn)	Adiciona a coluna especificada na coleção.
Add(String, String)	Adiciona um DataGridViewTextBoxColumn com o nome de coluna e o texto do cabeçalho de coluna fornecidos à coleção.
AddRange(DataGridViewColumn[])	Adiciona um intervalo de colunas à coleção.
Clear()	Limpa a coleção.
Contains(DataGridViewColumn)	Determina se a coleção contém a coluna fornecida.
Contains(String)	Determina se a coleção contém a coluna referenciada pelo nome fornecido.
CopyTo(Array, Int32)	Copia todos os elementos do Array unidimensional atual para o Array unidimensional especificado, começando no índice Array de destino especificado. (Herdado de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copia os itens da coleção para a matriz fornecida.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetColumnCount(DataGridViewElementStates)	Retorna o número de colunas que atendem aos requisitos de filtro indicados.
GetColumnsWidth(DataGridViewElementStates)	Retorna a largura, em pixels, necessária para exibir todas as colunas que atendem aos requisitos de determinado filtro.
GetEnumerator()	Obtém o objeto que permite a iteração através dos membros da coleção. (Herdado de BaseCollection)
GetFirstColumn(DataGridViewElementStates)	Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão fornecidos.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão e exclusão fornecidos.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Retorna a última coluna na ordem de exibição que atende aos requisitos de filtro fornecidos.
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Obtém a primeira coluna após a coluna indicada na ordem de exibição que atende aos requisitos de filtro.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Obtém a última coluna antes da coluna indicada na ordem de exibição que atende aos requisitos de filtro.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(DataGridViewColumn)	Obtém o índice do DataGridViewColumn fornecido na coleção.
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Insere uma coluna no índice especificado na coleção.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Aciona o evento CollectionChanged.
Remove(DataGridViewColumn)	Remove a coluna especificada da coleção.
Remove(String)	Remove a coluna com o nome especificado da coleção.
RemoveAt(Int32)	Remove a coluna no índice especificado na coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CollectionChanged

Ocorre quando a coleção é alterada.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia todo o conteúdo da coleção para um Array unidimensional compatível, começando pelo índice especificado da matriz de destino.
ICollection.Count	Obtém o número de elementos na coleção.
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado.
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.
IEnumerable.GetEnumerator()	Retorna um enumerador que itera pela coleção.
IList.Add(Object)	Adiciona o objeto ao final da coleção.
IList.Clear()	Remove todos os elementos da coleção.
IList.Contains(Object)	Determina se um objeto está na coleção.
IList.IndexOf(Object)	Determina o índice de um item específico na coleção.
IList.Insert(Int32, Object)	Insere um elemento na coleção no índice especificado.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
IList.Item[Int32]	Obtém ou define o elemento no índice especificado.
IList.Remove(Object)	Remove a primeira ocorrência do objeto especificado da coleção.
IList.RemoveAt(Int32)	Remove o elemento com o índice especificado da coleção.

Métodos de Extensão

Confira também

• DataGridView
• Columns
• DataGridViewColumn