DataGridViewColumnCollection Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object

MarshalByRefObject

BaseCollection
DataGridViewColumnCollection

Atributos: ListBindableAttribute

Implementaciones: ICollection IEnumerable IList

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

Producto	Versiones
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Compartir vía