DataGridViewColumnCollection Classe

Definição

Representa uma coleção de objetos DataGridViewColumn em um controle DataGridView.Represents a collection of DataGridViewColumn objects in a DataGridView control.

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
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList
Herança
DataGridViewColumnCollection
Atributos
Implementações

Exemplos

O exemplo de código a seguir ilustra o uso desse tipo.The following code example illustrates the use of this type.

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 DataGridView do controle.You can retrieve an instance of this class through the Columns property of the DataGridView control. A coleção mantém uma referência ao controle por meio da DataGridView propriedade.The collection maintains a reference to the control through the DataGridView property.

Construtores

DataGridViewColumnCollection(DataGridView)

Inicializa uma nova instância da classe DataGridViewColumnCollection para o DataGridView fornecido.Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Propriedades

Count

Obtém o número total de elementos na coleção.Gets the total number of elements in the collection.

(Herdado de BaseCollection)
DataGridView

Obtém o DataGridView no qual a coleção executa operações relacionadas à coluna.Gets the DataGridView upon which the collection performs column-related operations.

IsReadOnly

Obtém um valor que indica se a coleção é somente leitura.Gets a value indicating whether the collection is read-only.

(Herdado de BaseCollection)
IsSynchronized

Obtém um valor que indica se o acesso à ICollection é sincronizado.Gets a value indicating whether access to the ICollection is synchronized.

(Herdado de BaseCollection)
Item[Int32]

Obtém ou define a coluna no índice especificado na coleção.Gets or sets the column at the given index in the collection.

Item[String]

Obtém ou define a coluna do nome especificado na coleção.Gets or sets the column of the given name in the collection.

List

Obtém a lista de elementos contidos na instância BaseCollection.Gets the list of elements contained in the BaseCollection instance.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Herdado de BaseCollection)

Métodos

Add(DataGridViewColumn)

Adiciona a coluna especificada na coleção.Adds the given column to the collection.

Add(String, String)

Adiciona um DataGridViewTextBoxColumn com o nome de coluna e o texto do cabeçalho de coluna fornecidos à coleção.Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

AddRange(DataGridViewColumn[])

Adiciona um intervalo de colunas à coleção.Adds a range of columns to the collection.

Clear()

Limpa a coleção.Clears the collection.

Contains(DataGridViewColumn)

Determina se a coleção contém a coluna fornecida.Determines whether the collection contains the given column.

Contains(String)

Determina se a coleção contém a coluna referenciada pelo nome fornecido.Determines whether the collection contains the column referred to by the given name.

CopyTo(Array, Int32)

Copia todos os elementos do Array unidimensional atual para o Array unidimensional especificado, começando no índice Array de destino especificado.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Herdado de BaseCollection)
CopyTo(DataGridViewColumn[], Int32)

Copia os itens da coleção para a matriz fornecida.Copies the items from the collection to the given array.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetColumnCount(DataGridViewElementStates)

Retorna o número de colunas que atendem aos requisitos de filtro indicados.Returns the number of columns that meet the given filter requirements.

GetColumnsWidth(DataGridViewElementStates)

Retorna a largura, em pixels, necessária para exibir todas as colunas que atendem aos requisitos de determinado filtro.Returns the width, in pixels, required to display all of the columns that meet the given filter requirements.

GetEnumerator()

Obtém o objeto que permite a iteração através dos membros da coleção.Gets the object that enables iterating through the members of the collection.

(Herdado de BaseCollection)
GetFirstColumn(DataGridViewElementStates)

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão fornecidos.Returns the first column in display order that meets the given inclusion-filter requirements.

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.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

Retorna a última coluna na ordem de exibição que atende aos requisitos de filtro fornecidos.Returns the last column in display order that meets the given filter requirements.

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(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.Gets the first column after the given column in display order that meets the given filter requirements.

GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Obtém a última coluna antes da coluna indicada na ordem de exibição que atende aos requisitos de filtro.Gets the last column prior to the given column in display order that meets the given filter requirements.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(DataGridViewColumn)

Obtém o índice do DataGridViewColumn fornecido na coleção.Gets the index of the given DataGridViewColumn in the collection.

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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

Insere uma coluna no índice especificado na coleção.Inserts a column at the given index in the collection.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Aciona o evento CollectionChanged.Raises the CollectionChanged event.

Remove(DataGridViewColumn)

Remove a coluna especificada da coleção.Removes the specified column from the collection.

Remove(String)

Remove a coluna com o nome especificado da coleção.Removes the column with the specified name from the collection.

RemoveAt(Int32)

Remove a coluna no índice especificado na coleção.Removes the column at the given index in the collection.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Eventos

CollectionChanged

Ocorre quando a coleção é alterada.Occurs when the collection changes.

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.Copies the entire contents of the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Obtém o número de elementos na coleção.Gets the number of elements in the collection.

ICollection.IsSynchronized

Obtém um valor que indica se o acesso à coleção é sincronizado.Gets a value indicating whether access to the collection is synchronized.

ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Retorna um enumerador que itera pela coleção.Returns an enumerator that iterates through the collection.

IList.Add(Object)

Adiciona um objeto ao fim da coleção.Adds an object to the end of the collection.

IList.Clear()

Remove todos os elementos da coleção.Removes all elements from the collection.

IList.Contains(Object)

Determina se um objeto está na coleção.Determines whether an object is in the collection.

IList.IndexOf(Object)

Determina o índice de um item específico na coleção.Determines the index of a specific item in the collection.

IList.Insert(Int32, Object)

Insere um elemento na coleção no índice especificado.Inserts an element into the collection at the specified index.

IList.IsFixedSize

Obtém um valor que indica se a coleção tem um tamanho fixo.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Obtém um valor que indica se a coleção é somente leitura.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Obtém ou define o elemento no índice especificado.Gets or sets the element at the specified index.

IList.Remove(Object)

Remove a primeira ocorrência do objeto especificado da coleção.Removes the first occurrence of the specified object from the collection.

IList.RemoveAt(Int32)

Remove o elemento com o índice especificado da coleção.Removes the element with the specified index from the collection.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também