DataGridViewColumnCollection Classe

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma coleção de DataGridViewColumn objetos num DataGridView controlo.

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 seguinte ilustra o uso deste 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

Observações

Pode recuperar uma instância desta classe através da Columns propriedade do DataGridView controlo. A coleção mantém uma referência ao controlo através da DataGridView propriedade.

Construtores

Name	Description
DataGridViewColumnCollection(DataGridView)	Inicializa uma nova instância da DataGridViewColumnCollection classe para o dado DataGridView.

Propriedades

Name	Description
Count	Obtém o número total de elementos na coleção. (Herdado de BaseCollection)
DataGridView	Obtém o DataGridView sobre o qual a coleção realiza operações relacionadas com colunas.
IsReadOnly	Recebe um valor que indica se a coleção é apenas de leitura. (Herdado de BaseCollection)
IsSynchronized	Obtém um valor que indica se o acesso ao ICollection está sincronizado. (Herdado de BaseCollection)
Item[Int32]	Obtém ou define a coluna no índice dado na coleção.
Item[String]	Recebe ou define a coluna do nome próprio na coleção.
List	Obtém a lista de elementos contidos na BaseCollection instância.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao BaseCollection. (Herdado de BaseCollection)

Métodos

Name	Description
Add(DataGridViewColumn)	Adiciona a coluna dada à coleção.
Add(String, String)	Adiciona um DataGridViewTextBoxColumn com o nome da coluna indicado e o texto do cabeçalho da coluna à coleção.
AddRange(DataGridViewColumn[])	Adiciona uma variedade de colunas à coleção.
Clear()	Limpa a coleção.
Contains(DataGridViewColumn)	Determina se a coleção contém a coluna dada.
Contains(String)	Determina se a coleção contém a coluna referida pelo nome próprio.
CopyTo(Array, Int32)	Copia todos os elementos do unidimensional Array atual para o unidimensional Array especificado, começando no índice de destino Array especificado. (Herdado de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)	Copia os itens da coleção para o array dado.
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetColumnCount(DataGridViewElementStates)	Devolve o número de colunas que cumprem os requisitos de filtro dados.
GetColumnsWidth(DataGridViewElementStates)	Devolve a largura, em píxeis, necessária para mostrar todas as colunas que cumpram os requisitos de filtro indicados.
GetEnumerator()	Obtém o objeto que permite iterar através dos membros da coleção. (Herdado de BaseCollection)
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados de filtro de inclusão e filtro de exclusão.
GetFirstColumn(DataGridViewElementStates)	Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados do filtro de inclusão.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)	Devolve a última coluna na ordem de exibição que cumpre os requisitos de filtro dados.
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Recebe a primeira coluna após a coluna dada por ordem de exibição que cumpre os requisitos do filtro indicado.
GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)	Recebe a última coluna antes da coluna dada por ordem de exibição que cumpre os requisitos de filtro dados.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(DataGridViewColumn)	Obtém o índice dos dados DataGridViewColumn na coleção.
InitializeLifetimeService()	Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)	Insere uma coluna no índice indicado na coleção.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Eleva o CollectionChanged evento.
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 dado na coleção.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

evento

Name	Description
CollectionChanged	Ocorre quando a coleção muda.

Implementações de Interface Explícita

Name	Description
ICollection.CopyTo(Array, Int32)	Copia todo o conteúdo da coleção para um conjunto unidimensional Arraycompatível , começando no índice especificado do array alvo.
ICollection.Count	Obtém o número de elementos na coleção.
ICollection.IsSynchronized	Recebe um valor que indica se o acesso à coleção está sincronizado.
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.
IEnumerable.GetEnumerator()	Devolve um enumerador que itera pela coleção.
IList.Add(Object)	Adiciona um 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	Recebe um valor que indica se a coleção tem um tamanho fixo.
IList.IsReadOnly	Recebe um valor que indica se a coleção é apenas de 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 da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?