Compartilhar via


DataControlFieldCollection Classe

Definição

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::StateManagedCollection
public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection
type DataControlFieldCollection = class
    inherit StateManagedCollection
Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection
Herança
DataControlFieldCollection

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:

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 object contido na coleção a registrar seu estado inteiro para o estado de exibição, em vez de registrar apenas informações alteradas.

(Herdado de StateManagedCollection)
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 FieldChanged.

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 false em todos os casos.

(Herdado de StateManagedCollection)
ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção StateManagedCollection. Este método retorna null em todos os casos.

(Herdado de StateManagedCollection)
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 false em todos os casos.

(Herdado de StateManagedCollection)
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.

Aplica-se a

Confira também