DataControlFieldCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una raccolta di DataControlField oggetti utilizzati dai controlli associati a dati, GridView ad esempio 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- Ereditarietà
Commenti
La DataControlFieldCollection classe rappresenta una raccolta di DataControlField oggetti utilizzati dai controlli associati a dati per specificare la modalità di presentazione dei controlli figlio. La DataControlFieldCollection classe deriva da StateManagedCollection, una classe raccolta di base astratta utilizzata in modo specifico per archiviare IStateManager gli oggetti.
Un StateManagedCollection oggetto influenza il comportamento di un DataControlFieldCollection oggetto . DataControlField gli oggetti aggiunti dinamicamente all'insieme verranno aggiunti nuovamente al controllo quando viene ripristinato lo stato. Ciò significa che un campo deve essere aggiunto, rimosso o modificato una sola volta anziché in ogni postback, perché la maggior parte dei tipi di raccolta in ASP.NET necessario.
La DataControlField classe implementa l'interfaccia IStateManager , che consente di archiviarne lo stato in ASP.NET stato di visualizzazione.
Utilizzare la DataControlFieldCollection classe per gestire a livello di codice un set di DataControlField oggetti. Si noti che è più comune definire questi campi in modo dichiarativo.
È possibile aggiungere, inserire e rimuovere DataControlField oggetti usando i metodi appropriati della DataControlFieldCollection classe . Per recuperare DataControlField oggetti da una raccolta a livello di codice, utilizzare uno dei metodi seguenti:
Usare l'indicizzatore per ottenere un singolo DataControlField oggetto dalla raccolta usando la notazione della matrice.
Utilizzare il GetEnumerator metodo per creare un System.Collections.IEnumeratoroggetto implementato da , che può quindi essere usato per ottenere elementi dalla raccolta.
La Count proprietà specifica il numero totale di elementi nell'insieme e viene comunemente utilizzata per determinare il limite superiore dell'insieme. È possibile aggiungere e rimuovere elementi dalla raccolta usando i Addmetodi , InsertRemove, e RemoveAt .
Se si utilizza il GridView controllo o DetailsView , gli DataControlField oggetti creati automaticamente ( ad esempio, quando la AutoGenerateColumns proprietà è true) non vengono archiviati nell'insieme di campi accessibili pubblicamente. È possibile accedere e modificare DataControlField solo gli oggetti che non vengono generati automaticamente.
Nella tabella seguente sono elencate le diverse classi di campi di controllo dati e il modo in cui vengono usate.
| Classe Parameter | Descrizione |
|---|---|
| DataControlField | Classe base astratta per tutti i campi. |
| BoundField | Campo di controllo associato a dati utilizzato per l'associazione a testo o dati recuperati da un controllo origine dati ASP.NET. |
| ButtonFieldBase | Campo di controllo associato a dati che incapsula la funzionalità generale dei pulsanti. ButtonField e CheckBoxField sono derivati da esso. |
| ButtonField | Campo di controllo associato a dati che visualizza almeno un pulsante. |
| CheckBoxField | Campo di controllo associato a dati che visualizza un CheckBox controllo . |
| CommandField | Campo di controllo associato a dati che visualizza le azioni che possono essere eseguite sui dati visualizzati dalla riga (o dalla colonna), ad esempio modifica, aggiornamento o eliminazione. |
| HyperLinkField | Campo di controllo associato a dati che visualizza un HyperLink controllo . |
| ImageField | Campo di controllo associato a dati che visualizza un Image controllo . |
| TemplateField | Campo di controllo associato a dati che visualizza contenuto personalizzato in un controllo associato a dati. |
Costruttori
| Nome | Descrizione |
|---|---|
| DataControlFieldCollection() |
Inizializza una nuova istanza della classe DataControlFieldCollection. |
Proprietà
| Nome | Descrizione |
|---|---|
| Count |
Ottiene il numero di elementi contenuti nell'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| Item[Int32] |
Ottiene o imposta l'oggetto DataControlField in corrispondenza dell'indice specificato nell'insieme. |
Metodi
| Nome | Descrizione |
|---|---|
| Add(DataControlField) |
Accoda l'oggetto specificato DataControlField alla fine dell'insieme. |
| Clear() |
Rimuove tutti gli elementi dalla StateManagedCollection raccolta. (Ereditato da StateManagedCollection) |
| CloneFields() |
Crea una copia della raccolta corrente. |
| Contains(DataControlField) |
Determina se l'insieme DataControlFieldCollection contiene un oggetto specifico DataControlField . |
| CopyTo(Array, Int32) |
Copia gli elementi della StateManagedCollection raccolta in una matrice, a partire da un indice di matrice specifico. (Ereditato da StateManagedCollection) |
| CopyTo(DataControlField[], Int32) |
Copia l'intera DataControlFieldCollection raccolta in un oggetto unidimensionale Arraycompatibile, a partire dall'indice specificato della matrice di destinazione. |
| CreateKnownType(Int32) |
Quando sottoposto a override in una classe derivata, crea un'istanza di una classe che implementa IStateManager. Il tipo di oggetto creato si basa sul membro specificato della raccolta restituita dal GetKnownTypes() metodo . (Ereditato da StateManagedCollection) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetEnumerator() |
Restituisce un iteratore che scorre l'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetKnownTypes() |
In caso di override in una classe derivata, ottiene una matrice di IStateManager tipi che la StateManagedCollection raccolta può contenere. (Ereditato da StateManagedCollection) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IndexOf(DataControlField) |
Determina l'indice di un oggetto specifico DataControlField nell'insieme. |
| Insert(Int32, DataControlField) |
Inserisce l'oggetto specificato DataControlField nell'insieme DataControlFieldCollection in corrispondenza dell'indice specificato. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnClear() |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive prima che il Clear() metodo rimuova tutti gli elementi dalla raccolta. (Ereditato da StateManagedCollection) |
| OnClearComplete() |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive al termine della Clear() rimozione di tutti gli elementi dalla raccolta. (Ereditato da StateManagedCollection) |
| OnInsert(Int32, Object) |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive prima che il IList.Insert(Int32, Object) metodo o IList.Add(Object) aggiunga un elemento alla raccolta. (Ereditato da StateManagedCollection) |
| OnInsertComplete(Int32, Object) |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive dopo che il IList.Insert(Int32, Object) metodo o IList.Add(Object) aggiunge un elemento alla raccolta. (Ereditato da StateManagedCollection) |
| OnRemove(Int32, Object) |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive prima che il IList.Remove(Object) metodo o IList.RemoveAt(Int32) rimuova l'elemento specificato dalla raccolta. (Ereditato da StateManagedCollection) |
| OnRemoveComplete(Int32, Object) |
Quando sottoposto a override in una classe derivata, esegue operazioni aggiuntive dopo che il IList.Remove(Object) metodo o IList.RemoveAt(Int32) rimuove l'elemento specificato dalla raccolta. (Ereditato da StateManagedCollection) |
| OnValidate(Object) |
Quando sottoposto a override in una classe derivata, convalida un elemento della StateManagedCollection raccolta. (Ereditato da StateManagedCollection) |
| Remove(DataControlField) |
Rimuove l'oggetto specificato DataControlField dall'insieme DataControlFieldCollection . |
| RemoveAt(Int32) |
Rimuove l'oggetto DataControlField in corrispondenza dell'indice specificato dall'insieme DataControlFieldCollection . |
| SetDirty() |
Forza la serializzazione dell'intera StateManagedCollection raccolta nello stato di visualizzazione. (Ereditato da StateManagedCollection) |
| SetDirtyObject(Object) |
Quando sottoposto a override in una classe derivata, indica a un |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
| Nome | Descrizione |
|---|---|
| FieldsChanged |
Si verifica quando i campi nella raccolta cambiano, in genere come risultato di una Clear()chiamata al metodo , Insert(Int32, DataControlField)Remove(DataControlField) o Add(DataControlField) . Questo evento viene generato anche ogni volta che un DataControlField oggetto nella raccolta genera il relativo |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICollection.Count |
Ottiene il numero di elementi contenuti nell'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| ICollection.IsSynchronized |
Ottiene un valore che indica se la StateManagedCollection raccolta è sincronizzata (thread-safe). Questo metodo restituisce |
| ICollection.SyncRoot |
Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme StateManagedCollection . Questo metodo restituisce |
| IEnumerable.GetEnumerator() |
Restituisce un iteratore che scorre l'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| IList.Add(Object) |
Aggiunge un elemento alla StateManagedCollection raccolta. (Ereditato da StateManagedCollection) |
| IList.Clear() |
Rimuove tutti gli elementi dalla StateManagedCollection raccolta. (Ereditato da StateManagedCollection) |
| IList.Contains(Object) |
Determina se la StateManagedCollection raccolta contiene un valore specifico. (Ereditato da StateManagedCollection) |
| IList.IndexOf(Object) |
Determina l'indice di un elemento specificato nell'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| IList.Insert(Int32, Object) |
Inserisce un elemento nella StateManagedCollection raccolta in corrispondenza dell'indice specificato. (Ereditato da StateManagedCollection) |
| IList.IsFixedSize |
Ottiene un valore che indica se la StateManagedCollection raccolta ha una dimensione fissa. Questo metodo restituisce |
| IList.IsReadOnly |
Ottiene un valore che indica se l'insieme StateManagedCollection è di sola lettura. (Ereditato da StateManagedCollection) |
| IList.Item[Int32] |
Ottiene l'elemento IStateManager in corrispondenza dell'indice specificato. (Ereditato da StateManagedCollection) |
| IList.Remove(Object) |
Rimuove la prima occorrenza dell'oggetto specificato dall'insieme StateManagedCollection . (Ereditato da StateManagedCollection) |
| IList.RemoveAt(Int32) |
Rimuove l'elemento IStateManager in corrispondenza dell'indice specificato. (Ereditato da StateManagedCollection) |
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se la StateManagedCollection raccolta salva le modifiche apportate allo stato di visualizzazione. (Ereditato da StateManagedCollection) |
| IStateManager.LoadViewState(Object) |
Ripristina lo stato di visualizzazione salvato in precedenza della StateManagedCollection raccolta e gli IStateManager elementi contenuti. (Ereditato da StateManagedCollection) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate all'insieme StateManagedCollection e a ogni IStateManager oggetto che contiene dall'ora in cui la pagina è stata inviata nuovamente al server. (Ereditato da StateManagedCollection) |
| IStateManager.TrackViewState() |
Fa sì che l'insieme StateManagedCollection e ognuno degli oggetti che contiene tiene traccia delle IStateManager modifiche apportate allo stato di visualizzazione in modo che possano essere mantenute tra le richieste per la stessa pagina. (Ereditato da StateManagedCollection) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |
