DataControlFieldCollection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma coleção de objetos DataControlField usados por controles associados a dados como GridView e DetailsView.
public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollectionpublic sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollectiontype DataControlFieldCollection = class
inherit StateManagedCollectionPublic NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection- Herança
Comentários
A DataControlFieldCollection classe representa uma coleção de DataControlField objetos usados por controles associados a dados para especificar como seus controles filho são apresentados. A DataControlFieldCollection classe deriva de uma classe de StateManagedCollectioncoleção base abstrata usada especificamente para armazenar IStateManager objetos.
Um StateManagedCollection objeto influencia o comportamento de um DataControlFieldCollection objeto. DataControlField os objetos adicionados dinamicamente à coleção serão adicionados novamente ao controle quando o estado for restaurado. Isso significa que um campo precisa ser adicionado, removido ou alterado apenas uma vez em vez de em cada postback, como a maioria dos tipos de coleção em ASP.NET exige.
(A DataControlField classe implementa a interface, que IStateManager permite que ela armazene seu estado em ASP.NET estado de exibição. )
Use a DataControlFieldCollection classe para gerenciar programaticamente um conjunto de DataControlField objetos. Observe que é mais comum definir esses campos declarativamente.
Você pode adicionar, inserir e remover DataControlField objetos usando os métodos apropriados da DataControlFieldCollection classe. Para recuperar DataControlField objetos programaticamente de uma coleção, use um dos seguintes métodos:
Use o indexador para obter um único DataControlField objeto da coleção usando a notação de matriz.
Use o GetEnumerator método para criar um System.Collections.IEnumeratorobjeto implementado, que pode ser usado para obter itens da coleção.
A Count propriedade especifica o número total de itens na coleção e é comumente usada para determinar o limite superior da coleção. Você pode adicionar itens e remover itens da coleção usando os métodos e RemoveAt os InsertAddRemovemétodos.
Se você estiver usando o controle ou o GridView controle, os DataControlField objetos que são criados automaticamente (por exemplo, quando a AutoGenerateColumns propriedade é true) não serão armazenados na coleção de campos acessível publicamente.DetailsView Você só pode acessar e manipular DataControlField objetos que não são gerados automaticamente.
A tabela a seguir lista as diferentes classes de campo de controle de dados e como elas são usadas.
| Classe Parameter | Descrição |
|---|---|
| DataControlField | A classe base abstrata para todos os campos. |
| BoundField | Um campo de controle associado a dados que é usado para associar a texto ou dados recuperados de um controle de fonte de dados ASP.NET. |
| ButtonFieldBase | Um campo de controle associado a dados que encapsula a funcionalidade geral do botão. ButtonField e CheckBoxField são derivados dele. |
| ButtonField | Um campo de controle associado a dados que exibe pelo menos um botão. |
| CheckBoxField | Um campo de controle associado a dados que exibe um CheckBox controle. |
| CommandField | Um campo de controle associado a dados que exibe ações que podem ser executadas nos dados exibidos pela linha (ou coluna), como editar, atualizar ou excluir. |
| HyperLinkField | Um campo de controle associado a dados que exibe um HyperLink controle. |
| ImageField | Um campo de controle associado a dados que exibe um Image controle. |
| TemplateField | Um campo de controle associado a dados que exibe conteúdo personalizado em um controle associado a dados. |
Construtores
| DataControlFieldCollection() |
Inicializa uma nova instância da classe DataControlFieldCollection. |
Propriedades
| Count |
Obtém o número de elementos contidos na coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| Item[Int32] |
Obtém ou define o objeto DataControlField no índice especificado na coleção. |
Métodos
| Add(DataControlField) |
Acrescenta o objeto DataControlField especificado ao final da coleção. |
| Clear() |
Remove todos os itens da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| CloneFields() |
Cria uma cópia da coleção atual. |
| Contains(DataControlField) |
Determina se a coleção DataControlFieldCollection contém um objeto DataControlField específico. |
| CopyTo(Array, Int32) |
Copia os elementos da coleção StateManagedCollection para uma matriz, começando em um índice de matriz específico. (Herdado de StateManagedCollection) |
| CopyTo(DataControlField[], Int32) |
Copia toda a coleção DataControlFieldCollection para um Array unidimensional compatível, começando no índice especificado da matriz de destino. |
| CreateKnownType(Int32) |
Quando substituído em uma classe derivada, cria uma instância de uma classe que implementa IStateManager. O tipo de objeto criado se baseia no membro especificado da coleção retornada pelo método GetKnownTypes(). (Herdado de StateManagedCollection) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetEnumerator() |
Retorna um iterador que itera por meio da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetKnownTypes() |
Quando substituído em uma classe derivada, obtém uma matriz de tipos IStateManager que a coleção StateManagedCollection pode conter. (Herdado de StateManagedCollection) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IndexOf(DataControlField) |
Determina o índice de um objeto DataControlField específico na coleção. |
| Insert(Int32, DataControlField) |
Insere o objeto DataControlField especificado na coleção DataControlFieldCollection no índice especificado. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnClear() |
Quando substituído em uma classe derivada, executa o trabalho adicional antes do método Clear() remover todos os itens da coleção. (Herdado de StateManagedCollection) |
| OnClearComplete() |
Quando substituído em uma classe derivada, executa o trabalho adicional após o método Clear() terminar a remoção de todos os itens da coleção. (Herdado de StateManagedCollection) |
| OnInsert(Int32, Object) |
Quando substituído em uma classe derivada, executa o trabalho adicional antes do método IList.Insert(Int32, Object) ou IList.Add(Object) adicionar um item à coleção. (Herdado de StateManagedCollection) |
| OnInsertComplete(Int32, Object) |
Quando substituído em uma classe derivada, executa o trabalho adicional após o método IList.Insert(Int32, Object) ou IList.Add(Object) adicionar um item à coleção. (Herdado de StateManagedCollection) |
| OnRemove(Int32, Object) |
Quando substituído em uma classe derivada, executa o trabalho adicional antes do método IList.Remove(Object) ou IList.RemoveAt(Int32) remover o item especificado da coleção. (Herdado de StateManagedCollection) |
| OnRemoveComplete(Int32, Object) |
Quando substituído em uma classe derivada, executa o trabalho adicional após o método IList.Remove(Object) ou IList.RemoveAt(Int32) remover o item especificado da coleção. (Herdado de StateManagedCollection) |
| OnValidate(Object) |
Quando substituído em uma classe derivada, valida um elemento da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| Remove(DataControlField) |
Remove o objeto DataControlField especificado da coleção DataControlFieldCollection. |
| RemoveAt(Int32) |
Remove o objeto DataControlField no índice especificado da coleção DataControlFieldCollection. |
| SetDirty() |
Força a coleção StateManagedCollection inteira a ser serializada no estado de exibição. (Herdado de StateManagedCollection) |
| SetDirtyObject(Object) |
Quando substituído em uma classe derivada, instrui um |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Eventos
| FieldsChanged |
Ocorre quando os campos na coleção são alterados, geralmente como resultado de uma chamada de método Clear(), Insert(Int32, DataControlField), Remove(DataControlField) ou Add(DataControlField). Esse evento também é acionado a qualquer momento que um DataControlField na coleção aciona seu evento |
Implantações explícitas de interface
| ICollection.Count |
Obtém o número de elementos contidos na coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| ICollection.IsSynchronized |
Obtém um valor que indica se a coleção StateManagedCollection é sincronizada (thread-safe). Este método retorna |
| ICollection.SyncRoot |
Obtém um objeto que pode ser usado para sincronizar o acesso à coleção StateManagedCollection. Este método retorna |
| IEnumerable.GetEnumerator() |
Retorna um iterador que itera por meio da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| IList.Add(Object) |
Adiciona um item à coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| IList.Clear() |
Remove todos os itens da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| IList.Contains(Object) |
Determina se a coleção StateManagedCollection contém um valor específico. (Herdado de StateManagedCollection) |
| IList.IndexOf(Object) |
Determina o índice de um item especificado na coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| IList.Insert(Int32, Object) |
Insere um item na coleção StateManagedCollection no índice especificado. (Herdado de StateManagedCollection) |
| IList.IsFixedSize |
Obtém um valor que indica se a coleção StateManagedCollection tem um tamanho fixo. Este método retorna |
| IList.IsReadOnly |
Obtém um valor que indica se a coleção StateManagedCollection é somente leitura. (Herdado de StateManagedCollection) |
| IList.Item[Int32] |
Obtém o elemento IStateManager no índice especificado. (Herdado de StateManagedCollection) |
| IList.Remove(Object) |
Remove a primeira ocorrência do objeto especificado da coleção StateManagedCollection. (Herdado de StateManagedCollection) |
| IList.RemoveAt(Int32) |
Remove o elemento IStateManager no índice especificado. (Herdado de StateManagedCollection) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se a coleção StateManagedCollection está salvando alterações no estado de exibição. (Herdado de StateManagedCollection) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da coleção StateManagedCollection e o itens IStateManager que ele contém. (Herdado de StateManagedCollection) |
| IStateManager.SaveViewState() |
Salva as alterações na coleção StateManagedCollection e cada objeto IStateManager que ela contém, desde o momento em que a página foi postada novamente no servidor. (Herdado de StateManagedCollection) |
| IStateManager.TrackViewState() |
Faz com que a coleção StateManagedCollection e os objetos IStateManager que ela contém controlem as alterações realizadas no estado de exibição, para que elas possam ser mantidas em todas as solicitações para a mesma página. (Herdado de StateManagedCollection) |
Métodos de Extensão
| Cast<TResult>(IEnumerable) |
Converte os elementos de um IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base em um tipo especificado. |
| AsParallel(IEnumerable) |
Habilita a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable em um IQueryable. |