DataControlFieldCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma coleção de DataControlField objetos usados por controlos ligados 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
Observações
A DataControlFieldCollection classe representa um conjunto de DataControlField objetos usados pelos controlos encadernados por dados para especificar como os seus controlos filhos são apresentados. A DataControlFieldCollection classe deriva de StateManagedCollection, uma classe de coleção base abstrata usada especificamente para armazenar IStateManager objetos.
Um StateManagedCollection objeto influencia o comportamento de um DataControlFieldCollection objeto. DataControlField Os objetos que são adicionados dinamicamente à coleção serão novamente adicionados ao controlo quando o estado for restaurado. Isto significa que um campo precisa de ser adicionado, removido ou alterado apenas uma vez, em vez de em cada postback, como a maioria dos tipos de coleções no ASP.NET exige.
(A classe DataControlField implementa a interface IStateManager, que lhe permite armazenar o seu estado no estado ASP.NET vista.)
Use a DataControlFieldCollection classe para gerir programaticamente um conjunto de DataControlField objetos. Note-se que é mais comum definir estes campos de forma declarativa.
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:
Usa o indexador para obter um único DataControlField objeto da coleção usando notação de array.
Use o GetEnumerator método para criar um System.Collections.IEnumeratorobjeto -implementado, que depois pode ser usado para obter itens da coleção.
A Count propriedade especifica o número total de itens na coleção e é frequentemente usada para determinar o limite superior da coleção. Pode adicionar itens e remover itens da coleção usando os Addmétodos , Insert, Remove, e RemoveAt .
Se estiver a usar o GridView controlo ou, DetailsView os DataControlField objetos que são automaticamente criados (por exemplo, quando a AutoGenerateColumns propriedade é true) não são armazenados na coleção de campos acessíveis publicamente. Só podes aceder e manipular DataControlField objetos que não são gerados automaticamente.
A tabela seguinte lista as diferentes classes de campo de controlo de dados e como são utilizadas.
| Classe de parâmetros | Description |
|---|---|
| DataControlField | A classe base abstrata para todos os campos. |
| BoundField | Um campo de controlo ligado a dados que é usado para vincular a texto ou dados recuperados de um controlo de fonte de dados ASP.NET. |
| ButtonFieldBase | Um campo de controlo ligado a dados que encapsula a funcionalidade geral dos botões. ButtonField e CheckBoxField derivam dela. |
| ButtonField | Um campo de controlo vinculado a dados que mostra pelo menos um botão. |
| CheckBoxField | Um campo de controlo ligado a dados que mostra um CheckBox controlo. |
| CommandField | Um campo de controlo ligado a dados que mostra ações que podem ser realizadas sobre os dados apresentados pela linha (ou coluna), como editar, atualizar ou eliminar. |
| HyperLinkField | Um campo de controlo ligado a dados que mostra um HyperLink controlo. |
| ImageField | Um campo de controlo limitado por dados que mostra um Image controlo. |
| TemplateField | Um campo de controlo vinculado a dados que mostra conteúdo personalizado num controlo vinculado a dados. |
Construtores
| Name | Description |
|---|---|
| DataControlFieldCollection() |
Inicializa uma nova instância da DataControlFieldCollection classe. |
Propriedades
| Name | Description |
|---|---|
| Count |
Obtém o número de elementos contidos na StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| Item[Int32] |
Obtém ou define o DataControlField objeto no índice especificado na coleção. |
Métodos
| Name | Description |
|---|---|
| Add(DataControlField) |
Acrescenta o objeto especificado DataControlField ao final da coleção. |
| Clear() |
Remove todos os itens da StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| CloneFields() |
Cria uma cópia da coleção atual. |
| Contains(DataControlField) |
Determina se a DataControlFieldCollection coleção contém um objeto específico DataControlField . |
| CopyTo(Array, Int32) |
Copia os elementos da StateManagedCollection coleção para um array, começando num índice particular do array. (Herdado de StateManagedCollection) |
| CopyTo(DataControlField[], Int32) |
Copia toda DataControlFieldCollection a coleção para um conjunto unidimensional Arraycompatível , começando no índice especificado do array alvo. |
| CreateKnownType(Int32) |
Quando sobrescrito numa classe derivada, cria-se uma instância de uma classe que implementa IStateManager. O tipo de objeto criado baseia-se no membro especificado da coleção devolvido pelo GetKnownTypes() método. (Herdado de StateManagedCollection) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetEnumerator() |
Devolve um iterador que itera pela StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetKnownTypes() |
Quando é sobreposto numa classe derivada, obtém um array de IStateManager tipos que a StateManagedCollection coleção 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 específico DataControlField na coleção. |
| Insert(Int32, DataControlField) |
Insere o objeto especificado DataControlField na DataControlFieldCollection coleção no índice especificado. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnClear() |
Quando sobreposto numa classe derivada, realiza trabalho adicional antes de o Clear() método remover todos os itens da coleção. (Herdado de StateManagedCollection) |
| OnClearComplete() |
Quando sobreposto numa classe derivada, realiza trabalho adicional após o Clear() método terminar de remover todos os itens da coleção. (Herdado de StateManagedCollection) |
| OnInsert(Int32, Object) |
Quando sobreposto numa classe derivada, realiza trabalho adicional antes de o IList.Insert(Int32, Object) método ou IList.Add(Object) adicionar um item à coleção. (Herdado de StateManagedCollection) |
| OnInsertComplete(Int32, Object) |
Quando sobreposto numa classe derivada, realiza trabalho adicional após o IList.Insert(Int32, Object) método ou IList.Add(Object) adicionar um item à coleção. (Herdado de StateManagedCollection) |
| OnRemove(Int32, Object) |
Quando sobreposto numa classe derivada, realiza trabalho adicional antes de o IList.Remove(Object) método ou IList.RemoveAt(Int32) remover o item especificado da coleção. (Herdado de StateManagedCollection) |
| OnRemoveComplete(Int32, Object) |
Quando sobreposto numa classe derivada, realiza trabalho adicional após o IList.Remove(Object) método ou IList.RemoveAt(Int32) remover o item especificado da coleção. (Herdado de StateManagedCollection) |
| OnValidate(Object) |
Quando sobreposto numa classe derivada, valida um elemento da StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| Remove(DataControlField) |
Remove o objeto especificado DataControlField da DataControlFieldCollection coleção. |
| RemoveAt(Int32) |
Remove o DataControlField objeto no índice especificado da DataControlFieldCollection coleção. |
| SetDirty() |
Força toda a StateManagedCollection coleção a ser serializada no estado de visualização. (Herdado de StateManagedCollection) |
| SetDirtyObject(Object) |
Quando sobreposto numa classe derivada, instrui um |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
evento
| Name | Description |
|---|---|
| FieldsChanged |
Ocorre quando os campos na coleção mudam, geralmente como resultado de uma Clear()chamada , Insert(Int32, DataControlField), Remove(DataControlField) ou Add(DataControlField) de método. Este evento também é lançado sempre que um DataControlField elemento da coleção faz o seu |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICollection.Count |
Obtém o número de elementos contidos na StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| ICollection.IsSynchronized |
Recebe um valor que indica se a StateManagedCollection coleção está sincronizada (thread safe). Este método retorna |
| ICollection.SyncRoot |
Obtém um objeto que pode ser usado para sincronizar o acesso à StateManagedCollection coleção. Este método retorna |
| IEnumerable.GetEnumerator() |
Devolve um iterador que itera pela StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| IList.Add(Object) |
Adiciona um item à StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| IList.Clear() |
Remove todos os itens da StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| IList.Contains(Object) |
Determina se a StateManagedCollection coleção contém um valor específico. (Herdado de StateManagedCollection) |
| IList.IndexOf(Object) |
Determina o índice de um item especificado na StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| IList.Insert(Int32, Object) |
Insere um item na StateManagedCollection coleção no índice especificado. (Herdado de StateManagedCollection) |
| IList.IsFixedSize |
Recebe um valor que indica se a StateManagedCollection coleção tem um tamanho fixo. Este método retorna |
| IList.IsReadOnly |
Recebe um valor que indica se a StateManagedCollection coleção é apenas de leitura. (Herdado de StateManagedCollection) |
| IList.Item[Int32] |
Obtém o IStateManager elemento no índice especificado. (Herdado de StateManagedCollection) |
| IList.Remove(Object) |
Remove a primeira ocorrência do objeto especificado da StateManagedCollection coleção. (Herdado de StateManagedCollection) |
| IList.RemoveAt(Int32) |
Remove o IStateManager elemento no índice especificado. (Herdado de StateManagedCollection) |
| IStateManager.IsTrackingViewState |
Recebe um valor que indica se a StateManagedCollection coleção está a guardar alterações ao seu estado de visualização. (Herdado de StateManagedCollection) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de visualização previamente guardado da StateManagedCollection coleção e dos IStateManager itens que contém. (Herdado de StateManagedCollection) |
| IStateManager.SaveViewState() |
Guarda as alterações à StateManagedCollection coleção e a cada IStateManager objeto que contém desde o momento em que a página foi publicada de volta no servidor. (Herdado de StateManagedCollection) |
| IStateManager.TrackViewState() |
Faz com que a StateManagedCollection coleção e cada um dos IStateManager objetos que contém acompanhem alterações no estado da sua visualização para que possam ser persistidos entre pedidos para a mesma página. (Herdado de StateManagedCollection) |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |