Compartir a través de


DataGridViewColumnCollection Clase

Definición

Representa una colección de objetos DataGridViewColumn de un control 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
Herencia
DataGridViewColumnCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este 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

Comentarios

Puede recuperar una instancia de esta clase a través de la Columns propiedad del DataGridView control . La colección mantiene una referencia al control a través de la DataGridView propiedad .

Constructores

DataGridViewColumnCollection(DataGridView)

Inicializa una nueva instancia de la clase DataGridViewColumnCollection para el control DataGridView especificado.

Propiedades

Count

Obtiene el número total de elementos de la colección.

(Heredado de BaseCollection)
DataGridView

Obtiene el objeto DataGridView en el que la colección realiza las operaciones relacionadas con columna.

IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.

(Heredado de BaseCollection)
IsSynchronized

Obtiene un valor que indica si el acceso a ICollection está sincronizado.

(Heredado de BaseCollection)
Item[Int32]

Obtiene o establece la columna en el índice especificado de la colección.

Item[String]

Obtiene o establece la columna en el índice especificado de la colección.

List

Obtiene la lista de elementos incluidos en la instancia de BaseCollection.

SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a BaseCollection.

(Heredado de BaseCollection)

Métodos

Add(DataGridViewColumn)

Agrega la columna especificada a la colección.

Add(String, String)

Agrega a la colección una DataGridViewTextBoxColumn con el nombre de columna y el texto del encabezado de columna dados.

AddRange(DataGridViewColumn[])

Agrega un intervalo de columnas a la colección.

Clear()

Borra la colección.

Contains(DataGridViewColumn)

Determina si la colección contiene la columna especificada.

Contains(String)

Determina si la colección contiene la columna a la que se hace referencia mediante el nombre especificado.

CopyTo(Array, Int32)

Copia todos los elementos del objeto Array unidimensional actual en el objeto Array unidimensional especificado, empezando en el índice especificado del objeto Array de destino.

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

Copia los elementos de la colección a la matriz especificada.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetColumnCount(DataGridViewElementStates)

Devuelve el número de columnas que cumplen los requisitos de filtro especificados.

GetColumnsWidth(DataGridViewElementStates)

Devuelve el ancho, en píxeles, exigido para mostrar todas las columnas que cumplen los requisitos de filtro especificados.

GetEnumerator()

Obtiene el objeto que permite iterar en los miembros de la colección.

(Heredado de BaseCollection)
GetFirstColumn(DataGridViewElementStates)

Devuelve la primera columna en el orden de presentación que cumple los requisitos de filtro-inclusión especificados.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Devuelve la primera columna en el orden de presentación que cumple los requisitos de filtro de inclusión y de filtro de exclusión especificados.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

Devuelve la última columna en el orden de presentación que cumple los requisitos de filtro especificados.

GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Obtiene la primera columna tras la columna especificada en el orden de presentación que cumple los requisitos de filtro especificados.

GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Obtiene la última columna tras la columna especificada en el orden de presentación que cumple los requisitos de filtro especificados.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IndexOf(DataGridViewColumn)

Obtiene el índice del objeto DataGridViewColumn especificado en la colección.

InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

Inserta una columna en el índice especificado en la colección.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Genera el evento CollectionChanged.

Remove(DataGridViewColumn)

Quita de la colección la columna especificada.

Remove(String)

Quita de la colección la columna con el nombre especificado.

RemoveAt(Int32)

Quita la columna de la colección en el índice especificado.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Eventos

CollectionChanged

Aparece cuando cambia la colección.

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Copia el contenido completo de la colección en una clase Array unidimensional compatible, empezando en el índice especificado de la matriz de destino.

ICollection.Count

Obtiene el número de elementos de la colección.

ICollection.IsSynchronized

Obtiene un valor que indica si se sincroniza el acceso a la recopilación.

ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.

IEnumerable.GetEnumerator()

Devuelve un enumerador que procesa una iteración en la colección.

IList.Add(Object)

Agrega un objeto al final de la colección.

IList.Clear()

Quita todos los elementos de la colección.

IList.Contains(Object)

Determina si un objeto se encuentra en la colección.

IList.IndexOf(Object)

Determina el índice de un elemento específico de la colección.

IList.Insert(Int32, Object)

Inserta un elemento en la colección en el índice especificado.

IList.IsFixedSize

Obtiene un valor que indica si la colección tiene un tamaño fijo.

IList.IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.

IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.

IList.Remove(Object)

Quita la primera aparición del objeto especificado de la colección.

IList.RemoveAt(Int32)

Quita de la colección el elemento con el índice especificado.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también