DataControlFieldCollection Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.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 DataControlField usados por los controles enlazados a datos, como GridView y DetailsView.

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection

public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection

type DataControlFieldCollection = class
    inherit StateManagedCollection

Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection

Herencia: Object

StateManagedCollection
DataControlFieldCollection

Comentarios

La DataControlFieldCollection clase representa una colección de DataControlField objetos utilizados por los controles enlazados a datos para especificar cómo se presentan sus controles secundarios. La DataControlFieldCollection clase deriva de StateManagedCollection, una clase de colección base abstracta que se usa específicamente para almacenar IStateManager objetos.

Un StateManagedCollection objeto influye en el comportamiento de un DataControlFieldCollection objeto . DataControlField los objetos que se agregan dinámicamente a la colección se volverán a agregar al control cuando se restaure el estado. Esto significa que es necesario agregar, quitar o cambiar un campo una sola vez en lugar de en cada postback, ya que la mayoría de los tipos de colección de ASP.NET requieren.

(La DataControlField clase implementa la IStateManager interfaz , que permite almacenar su estado en ASP.NET estado de vista. )

Use la DataControlFieldCollection clase para administrar mediante programación un conjunto de DataControlField objetos. Tenga en cuenta que es más común definir estos campos mediante declaración.

Puede agregar, insertar y quitar DataControlField objetos mediante los métodos adecuados de la DataControlFieldCollection clase . Para recuperar DataControlField objetos de una colección mediante programación, use uno de los métodos siguientes:

Use el indexador para obtener un único DataControlField objeto de la colección mediante la notación de matriz.
Use el GetEnumerator método para crear un System.Collections.IEnumeratorobjeto implementado, que se puede usar para obtener elementos de la colección.

La Count propiedad especifica el número total de elementos de la colección y se usa normalmente para determinar el límite superior de la colección. Puede agregar y quitar elementos de la colección mediante los Addmétodos , Insert, Removey RemoveAt .

Si usa el GridView control o DetailsView , los DataControlField objetos que se crean automáticamente (por ejemplo, cuando la AutoGenerateColumns propiedad es true) no se almacenan en la colección de campos accesibles públicamente. Solo puede acceder a los objetos que no se generan automáticamente y manipular DataControlField .

En la tabla siguiente se enumeran las diferentes clases de campo de control de datos y cómo se usan.

Clase Parameter	Descripción
DataControlField	Clase base abstracta para todos los campos.
BoundField	Campo de control enlazado a datos que se usa para enlazar texto o datos recuperados de un control de origen de datos de ASP.NET.
ButtonFieldBase	Campo de control enlazado a datos que encapsula la funcionalidad general del botón. ButtonField y CheckBoxField se derivan de ella.
ButtonField	Campo de control enlazado a datos que muestra al menos un botón.
CheckBoxField	Campo de control enlazado a datos que muestra un CheckBox control.
CommandField	Campo de control enlazado a datos que muestra las acciones que se pueden realizar en los datos mostrados por la fila (o columna), como editar, actualizar o eliminar.
HyperLinkField	Campo de control enlazado a datos que muestra un HyperLink control.
ImageField	Campo de control enlazado a datos que muestra un Image control.
TemplateField	Campo de control enlazado a datos que muestra contenido personalizado en un control enlazado a datos.

Constructores

DataControlFieldCollection()

Inicializa una nueva instancia de la clase DataControlFieldCollection.

Propiedades

Count	Obtiene el número de elementos incluidos en la colección StateManagedCollection. (Heredado de StateManagedCollection)
Item[Int32]	Obtiene o establece el objeto DataControlField en el índice especificado de la colección.

Métodos

Add(DataControlField)	Agrega el objeto DataControlField especificado al final de la colección.
Clear()	Quita todos los elementos de la colección StateManagedCollection. (Heredado de StateManagedCollection)
CloneFields()	Crea una copia de la colección actual.
Contains(DataControlField)	Determina si la colección DataControlFieldCollection contiene un objeto DataControlField específico.
CopyTo(Array, Int32)	Copia los elementos de la colección StateManagedCollection en una matriz a partir de un índice de matriz concreto. (Heredado de StateManagedCollection)
CopyTo(DataControlField[], Int32)	Copia toda la colección DataControlFieldCollection en una matriz Array unidimensional y compatible, comenzando en el índice especificado de la matriz de destino.
CreateKnownType(Int32)	Cuando se reemplaza en una clase derivada, crea una instancia de una clase que implementa IStateManager. El tipo de objeto creado se basa en el miembro especificado de la colección devuelto por el método GetKnownTypes(). (Heredado de StateManagedCollection)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un iterador que permite recorrer en iteración la colección StateManagedCollection. (Heredado de StateManagedCollection)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetKnownTypes()	Cuando se reemplaza en una clase derivada, obtiene una matriz de tipos IStateManager que la colección StateManagedCollection puede contener. (Heredado de StateManagedCollection)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(DataControlField)	Determina el índice de un objeto DataControlField especificado en la colección.
Insert(Int32, DataControlField)	Inserta el objeto DataControlField especificado en el índice especificado de la colección DataControlFieldCollection.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnClear()	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional antes de que el método Clear() quite todos los elementos de la colección. (Heredado de StateManagedCollection)
OnClearComplete()	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional después de que el método Clear() termine de quitar todos los elementos de la colección. (Heredado de StateManagedCollection)
OnInsert(Int32, Object)	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional antes de que los métodos IList.Insert(Int32, Object) o IList.Add(Object) agreguen un elemento a la colección. (Heredado de StateManagedCollection)
OnInsertComplete(Int32, Object)	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional después de que los métodos IList.Insert(Int32, Object) o IList.Add(Object) agreguen un elemento a la colección. (Heredado de StateManagedCollection)
OnRemove(Int32, Object)	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional antes de que los métodos IList.Remove(Object) o IList.RemoveAt(Int32) quiten el elemento especificado de la colección. (Heredado de StateManagedCollection)
OnRemoveComplete(Int32, Object)	Cuando se reemplaza en una clase derivada, realiza un trabajo adicional después de que los métodos IList.Remove(Object) o IList.RemoveAt(Int32) quiten el elemento especificado de la colección. (Heredado de StateManagedCollection)
OnValidate(Object)	Cuando se reemplaza en una clase derivada, valida un elemento de la colección StateManagedCollection. (Heredado de StateManagedCollection)
Remove(DataControlField)	Quita el objeto DataControlField especificado de la colección DataControlFieldCollection.
RemoveAt(Int32)	Quita el objeto DataControlField del índice especificado de la colección DataControlFieldCollection.
SetDirty()	Obliga a serializar la colección StateManagedCollection completa en el estado de vista. (Heredado de StateManagedCollection)
SetDirtyObject(Object)	Cuando se reemplaza en una clase derivada, indica a un `object` incluido en la colección que registre su estado completo en el estado de vista, en lugar de registrar solo la información correspondiente a los cambios. (Heredado de StateManagedCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

FieldsChanged

Aparece cuando los campos de la colección cambian, normalmente como resultado de una llamada al método Clear(), Insert(Int32, DataControlField), Remove(DataControlField) o Add(DataControlField). Este evento también se genera siempre que un objeto DataControlField de la colección genera su evento FieldChanged.

Implementaciones de interfaz explícitas

ICollection.Count	Obtiene el número de elementos incluidos en la colección StateManagedCollection. (Heredado de StateManagedCollection)
ICollection.IsSynchronized	Obtiene un valor que indica si la colección StateManagedCollection está sincronizada (seguro para subprocesos). Este método devuelve `false` en todos los casos. (Heredado de StateManagedCollection)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a la colección StateManagedCollection. Este método devuelve `null` en todos los casos. (Heredado de StateManagedCollection)
IEnumerable.GetEnumerator()	Devuelve un iterador que permite recorrer en iteración la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.Add(Object)	Agrega un elemento a la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.Clear()	Quita todos los elementos de la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.Contains(Object)	Determina si la colección StateManagedCollection contiene un valor específico. (Heredado de StateManagedCollection)
IList.IndexOf(Object)	Determina el índice de un elemento especificado en la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.Insert(Int32, Object)	Inserta un elemento en el índice especificado de la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.IsFixedSize	Obtiene un valor que indica si la colección StateManagedCollection tiene un tamaño fijo. Este método devuelve `false` en todos los casos. (Heredado de StateManagedCollection)
IList.IsReadOnly	Obtiene un valor que indica si la colección StateManagedCollection es de solo lectura. (Heredado de StateManagedCollection)
IList.Item[Int32]	Obtiene el elemento IStateManager en el índice especificado. (Heredado de StateManagedCollection)
IList.Remove(Object)	Quita la primera aparición del objeto especificado de la colección StateManagedCollection. (Heredado de StateManagedCollection)
IList.RemoveAt(Int32)	Quita el elemento IStateManager en el índice especificado. (Heredado de StateManagedCollection)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si la colección StateManagedCollection está guardando los cambios en su estado de vista. (Heredado de StateManagedCollection)
IStateManager.LoadViewState(Object)	Restaura el estado de vista previamente guardado de la colección StateManagedCollection y de los elementos IStateManager que contiene. (Heredado de StateManagedCollection)
IStateManager.SaveViewState()	Guarda los cambios realizados en la colección StateManagedCollection y en cada objeto IStateManager que contiene desde el momento en que la página se devolvió al servidor. (Heredado de StateManagedCollection)
IStateManager.TrackViewState()	Hace que la colección StateManagedCollection y cada uno de los objetos IStateManager que contiene realicen un seguimiento de los cambios en el estado de vista para que se puedan conservar entre distintas solicitudes de la misma página. (Heredado de StateManagedCollection)

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