DataGridViewColumnCollection Clase

Definición

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

Ejemplos

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

Comentarios

Puede recuperar una instancia de esta clase a través Columns DataGridView de la propiedad del control.You can retrieve an instance of this class through the Columns property of the DataGridView control. La colección mantiene una referencia al control a través de DataGridView la propiedad.The collection maintains a reference to the control through the DataGridView property.

Constructores

DataGridViewColumnCollection(DataGridView)

Inicializa una nueva instancia de la clase DataGridViewColumnCollection para el control DataGridView especificado.Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Propiedades

Count

Obtiene el número total de elementos de la colección.Gets the total number of elements in the collection.

(Heredado de BaseCollection)
DataGridView

Obtiene el objeto DataGridView en el que la colección realiza las operaciones relacionadas con columna.Gets the DataGridView upon which the collection performs column-related operations.

IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

(Heredado de BaseCollection)
IsSynchronized

Obtiene un valor que indica si el acceso a ICollection está sincronizado.Gets a value indicating whether access to the ICollection is synchronized.

(Heredado de BaseCollection)
Item[Int32]

Obtiene o establece la columna en el índice especificado de la colección.Gets or sets the column at the given index in the collection.

Item[String]

Obtiene o establece la columna en el índice especificado de la colección.Gets or sets the column of the given name in the collection.

List

Obtiene la lista de elementos incluidos en la instancia de BaseCollection.Gets the list of elements contained in the BaseCollection instance.

SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Heredado de BaseCollection)

Métodos

Add(DataGridViewColumn)

Agrega la columna especificada a la colección.Adds the given column to the collection.

Add(String, String)

Agrega a la colección una DataGridViewTextBoxColumn con el nombre de columna y el texto del encabezado de columna dados.Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

AddRange(DataGridViewColumn[])

Agrega un intervalo de columnas a la colección.Adds a range of columns to the collection.

Clear()

Borra la colección.Clears the collection.

Contains(DataGridViewColumn)

Determina si la colección contiene la columna especificada.Determines whether the collection contains the given column.

Contains(String)

Determina si la colección contiene la columna a la que se hace referencia mediante el nombre especificado.Determines whether the collection contains the column referred to by the given name.

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.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

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

Copia los elementos de la colección a la matriz especificada.Copies the items from the collection to the given array.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetColumnCount(DataGridViewElementStates)

Devuelve el número de columnas que cumplen los requisitos de filtro especificados.Returns the number of columns that meet the given filter requirements.

GetColumnsWidth(DataGridViewElementStates)

Devuelve el ancho, en píxeles, exigido para mostrar todas las columnas que cumplen los requisitos de filtro especificados.Returns the width, in pixels, required to display all of the columns that meet the given filter requirements.

GetEnumerator()

Obtiene el objeto que permite iterar en los miembros de la colección.Gets the object that enables iterating through the members of the collection.

(Heredado de BaseCollection)
GetFirstColumn(DataGridViewElementStates)

Devuelve la primera columna en el orden de presentación que cumple los requisitos de filtro-inclusión especificados.Returns the first column in display order that meets the given inclusion-filter requirements.

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

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

Devuelve la última columna en el orden de presentación que cumple los requisitos de filtro especificados.Returns the last column in display order that meets the given filter requirements.

GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

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.Gets the last column prior to the given column in display order that meets the given filter requirements.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(DataGridViewColumn)

Obtiene el índice del objeto DataGridViewColumn especificado en la colección.Gets the index of the given DataGridViewColumn in the collection.

InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

Inserta una columna en el índice especificado en la colección.Inserts a column at the given index in the collection.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Genera el evento CollectionChanged.Raises the CollectionChanged event.

Remove(DataGridViewColumn)

Quita la columna especificada de la colección.Removes the specified column from the collection.

Remove(String)

Quita de la colección la columna con el nombre especificado.Removes the column with the specified name from the collection.

RemoveAt(Int32)

Quita la columna de la colección en el índice especificado.Removes the column at the given index in the collection.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Eventos

CollectionChanged

Se produce cuando cambia la colección.Occurs when the collection changes.

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

ICollection.Count

Obtiene el número de elementos de la colección.Gets the number of elements in the collection.

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la colección está sincronizado.Gets a value indicating whether access to the collection is synchronized.

ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Devuelve un enumerador que procesa una iteración en la colección.Returns an enumerator that iterates through the collection.

IList.Add(Object)

Agrega un objeto al final de la colección.Adds an object to the end of the collection.

IList.Clear()

Quita todos los elementos de la colección.Removes all elements from the collection.

IList.Contains(Object)

Determina si un objeto se encuentra en la colección.Determines whether an object is in the collection.

IList.IndexOf(Object)

Determina el índice de un elemento específico de la colección.Determines the index of a specific item in the collection.

IList.Insert(Int32, Object)

Inserta un elemento en la colección en el índice especificado.Inserts an element into the collection at the specified index.

IList.IsFixedSize

Obtiene un valor que indica si la colección tiene un tamaño fijo.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.Gets or sets the element at the specified index.

IList.Remove(Object)

Quita la primera aparición del objeto especificado de la colección.Removes the first occurrence of the specified object from the collection.

IList.RemoveAt(Int32)

Quita de la colección el elemento con el índice especificado.Removes the element with the specified index from the collection.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: