DataControlFieldCollection Classe

Definizione

Rappresenta una raccolta di oggetti DataControlField usati da un controllo associato a dati, ad esempio GridView e DetailsView.Represents a collection of DataControlField objects that are used by data-bound controls such as GridView and 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
Ereditarietà
DataControlFieldCollection

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.The DataControlFieldCollection class represents a collection of DataControlField objects used by data-bound controls to specify how their child controls are presented. La DataControlFieldCollection classe deriva da StateManagedCollection, una classe di raccolte di base astratta utilizzata in modo IStateManager specifico per archiviare oggetti.The DataControlFieldCollection class derives from StateManagedCollection, an abstract base collection class used specifically to store IStateManager objects.

Un StateManagedCollection oggetto influisce sul comportamento di DataControlFieldCollection un oggetto.A StateManagedCollection object influences the behavior of a DataControlFieldCollection object. DataControlFieldgli oggetti aggiunti dinamicamente alla raccolta verranno aggiunti di nuovo al controllo quando lo stato viene ripristinato.DataControlField objects that are dynamically added to the collection will be re-added to the control when state is restored. Questo 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 richiede.This means that a field needs to be added, removed, or changed just once instead of on each postback, as most collection types in ASP.NET require.

La DataControlField classe implementa l' IStateManager interfaccia, che consente di archiviare lo stato nello stato di visualizzazione ASP.NET.(The DataControlField class implements the IStateManager interface, which enables it to store its state in ASP.NET view state. ))

Utilizzare la DataControlFieldCollection classe per gestire a livello di codice un DataControlField set di oggetti.Use the DataControlFieldCollection class to programmatically manage a set of DataControlField objects. Si noti che è più comune definire questi campi in modo dichiarativo.Note that it is more common to define these fields declaratively.

È possibile aggiungere, inserire e rimuovere DataControlField oggetti usando i metodi appropriati DataControlFieldCollection della classe.You can add, insert, and remove DataControlField objects using the appropriate methods of the DataControlFieldCollection class. Per recuperare DataControlField oggetti da una raccolta a livello di codice, usare uno dei metodi seguenti:To programmatically retrieve DataControlField objects from a collection, use one of following methods:

La Count proprietà specifica il numero totale di elementi nella raccolta e viene comunemente utilizzata per determinare il limite superiore della raccolta.The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. È possibile aggiungere e rimuovere elementi dalla raccolta Addusando i metodi Remove, Insert, e RemoveAt .You can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

Se si GridView usa il controllo o DetailsView , gli DataControlField oggetti creati automaticamente (ad esempio, quando la AutoGenerateColumns proprietà è true) non vengono archiviati nella raccolta di campi accessibili pubblicamente.If you are using the GridView or DetailsView control, the DataControlField objects that are automatically created (for example, when the AutoGenerateColumns property is true) are not stored in the publicly accessible fields collection. È possibile accedere e modificare DataControlField solo gli oggetti che non vengono generati automaticamente.You can only access and manipulate DataControlField objects that are not automatically generated.

La tabella seguente elenca le diverse classi di campo di controllo dei dati e il modo in cui vengono usate.The following table lists the different data control field classes and how they are used.

Classe ParameterParameter Class DescriptionDescription
DataControlField Classe di base astratta per tutti i campi.The abstract base class for all fields.
BoundField Campo di controllo associato a dati utilizzato per associare il testo o i dati recuperati da un controllo origine dati ASP.NET.A data-bound control field that is used to bind to text or data retrieved from an ASP.NET data source control.
ButtonFieldBase Campo di controllo con associazione a dati che incapsula la funzionalità del pulsante generale.A data-bound control field that encapsulates general button functionality. ButtonFielde CheckBoxField derivano da esso.ButtonField and CheckBoxField are derived from it.
ButtonField Un campo di controllo con associazione a dati che visualizza almeno un pulsante.A data-bound control field that displays at least one button.
CheckBoxField Campo di controllo con associazione a dati che visualizza CheckBox un controllo.A data-bound control field that displays a CheckBox control.
CommandField Campo di controllo associato a dati che consente di visualizzare le azioni che possono essere eseguite sui dati visualizzati dalla riga (o colonna), ad esempio modifica, aggiornamento o eliminazione.A data-bound control field that displays actions that can be performed on the data displayed by the row (or column), such as edit, update, or delete.
HyperLinkField Campo di controllo con associazione a dati che visualizza HyperLink un controllo.A data-bound control field that displays a HyperLink control.
ImageField Campo di controllo con associazione a dati che visualizza Image un controllo.A data-bound control field that displays an Image control.
TemplateField Campo di controllo con associazione a dati che Visualizza contenuto personalizzato in un controllo associato a dati.A data-bound control field that displays custom content in a data-bound control.

Costruttori

DataControlFieldCollection()

Inizializza una nuova istanza della classe DataControlFieldCollection.Initializes a new instance of the DataControlFieldCollection class.

Proprietà

Count

Ottiene il numero di elementi contenuti nella raccolta StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
Item[Int32]

Ottiene o imposta l'oggetto DataControlField nella raccolta, in corrispondenza dell'indice specificato.Gets or sets the DataControlField object at the specified index in the collection.

Metodi

Add(DataControlField)

Aggiunge l'oggetto DataControlField specificato alla fine dell'insieme.Appends the specified DataControlField object to the end of the collection.

Clear()

Rimuove tutti gli elementi dalla raccolta StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
CloneFields()

Crea una copia dell'insieme corrente.Creates a copy of the current collection.

Contains(DataControlField)

Determina se l'insieme DataControlFieldCollection contiene un oggetto DataControlField specifico.Determines whether the DataControlFieldCollection collection contains a specific DataControlField object.

CopyTo(Array, Int32)

Copia gli elementi della raccolta StateManagedCollection in una matrice, a partire da un indice della matrice specifico.Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Ereditato da StateManagedCollection)
CopyTo(DataControlField[], Int32)

Copia l'intero insieme DataControlFieldCollection in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.Copies the entire DataControlFieldCollection collection to a compatible one-dimensional Array, starting at the specified index of the target array.

CreateKnownType(Int32)

Quando sottoposto a override in una classe derivata, crea un'istanza di una classe che implementa IStateManager.When overridden in a derived class, creates an instance of a class that implements IStateManager. Il tipo di oggetto creato è basato sul membro specificato della raccolta restituita dal metodo GetKnownTypes().The type of object created is based on the specified member of the collection returned by the GetKnownTypes() method.

(Ereditato da StateManagedCollection)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetEnumerator()

Restituisce un iteratore che consente di scorrere la raccolta StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetKnownTypes()

Quando sottoposto a override in una classe derivata, ottiene una matrice di tipi IStateManager che possono essere inclusi nella raccolta StateManagedCollection.When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain.

(Ereditato da StateManagedCollection)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IndexOf(DataControlField)

Determina l'indice di un oggetto DataControlField specifico nell'insieme.Determines the index of a specific DataControlField object in the collection.

Insert(Int32, DataControlField)

Inserisce l'oggetto DataControlField specificato nell'insieme DataControlFieldCollection in corrispondenza dell'indice specificato.Inserts the specified DataControlField object into the DataControlFieldCollection collection at the specified index.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnClear()

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni prima che il metodo Clear() rimuova tutti gli elementi dalla raccolta.When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Ereditato da StateManagedCollection)
OnClearComplete()

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni dopo che il metodo Clear() ha completato la rimozione di tutti gli elementi dalla raccolta.When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection.

(Ereditato da StateManagedCollection)
OnInsert(Int32, Object)

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni prima che il metodo IList.Insert(Int32, Object) o IList.Add(Object) aggiunga un elemento alla raccolta.When overridden in a derived class, performs additional work before the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Ereditato da StateManagedCollection)
OnInsertComplete(Int32, Object)

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni dopo che il metodo IList.Insert(Int32, Object) o IList.Add(Object) ha aggiunto un elemento alla raccolta.When overridden in a derived class, performs additional work after the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Ereditato da StateManagedCollection)
OnRemove(Int32, Object)

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni prima che il metodo IList.Remove(Object) o IList.RemoveAt(Int32) rimuova l'elemento specificato dalla raccolta.When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Ereditato da StateManagedCollection)
OnRemoveComplete(Int32, Object)

Quando sottoposto a override in una classe derivata, esegue ulteriori operazioni dopo che il metodo IList.Remove(Object) o IList.RemoveAt(Int32) ha completato la rimozione dell'elemento specificato dalla raccolta.When overridden in a derived class, performs additional work after the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Ereditato da StateManagedCollection)
OnValidate(Object)

Quando sottoposto a override in una classe derivata, convalida un elemento della raccolta StateManagedCollection.When overridden in a derived class, validates an element of the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
Remove(DataControlField)

Rimuove l'oggetto DataControlField specificato dall'insieme DataControlFieldCollection.Removes the specified DataControlField object from the DataControlFieldCollection collection.

RemoveAt(Int32)

Rimuove l'oggetto DataControlField in corrispondenza dell'indice specificato dall'insieme DataControlFieldCollection.Removes the DataControlField object at the specified index from the DataControlFieldCollection collection.

SetDirty()

Impone la serializzazione dell'intera raccolta StateManagedCollection nello stato di visualizzazione.Forces the entire StateManagedCollection collection to be serialized into view state.

(Ereditato da StateManagedCollection)
SetDirtyObject(Object)

Quando sottoposto a override in una classe derivata, richiede a un object incluso nella raccolta di registrare il rispettivo stato completo nello stato di visualizzazione, invece di registrare solo le informazioni relative alle modifiche.When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information.

(Ereditato da StateManagedCollection)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Eventi

FieldsChanged

Si verifica quando si modificano i campi nell'insieme, in genere come conseguenza di una chiamata al metodo Clear(), Insert(Int32, DataControlField), Remove(DataControlField) o Add(DataControlField).Occurs when the fields in the collection change, usually as the result of a Clear(), Insert(Int32, DataControlField), Remove(DataControlField) or Add(DataControlField) method call. Questo evento viene generato anche ogni volta che un oggetto DataControlField nell'insieme genera il relativo evento FieldChanged.This event is also raised anytime a DataControlField in the collection raises its FieldChanged event.

Implementazioni dell'interfaccia esplicita

ICollection.Count

Ottiene il numero di elementi contenuti nella raccolta StateManagedCollection.Gets the number of elements contained in the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
ICollection.IsSynchronized

Ottiene un valore che indica se la raccolta StateManagedCollection è sincronizzata (thread-safe).Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). Questo metodo restituisce false in tutti i casi.This method returns false in all cases.

(Ereditato da StateManagedCollection)
ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta StateManagedCollection .Gets an object that can be used to synchronize access to the StateManagedCollection collection. Questo metodo restituisce null in tutti i casi.This method returns null in all cases.

(Ereditato da StateManagedCollection)
IEnumerable.GetEnumerator()

Restituisce un iteratore che consente di scorrere la raccolta StateManagedCollection.Returns an iterator that iterates through the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
IList.Add(Object)

Aggiunge un elemento alla raccolta StateManagedCollection.Adds an item to the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
IList.Clear()

Rimuove tutti gli elementi dalla raccolta StateManagedCollection.Removes all items from the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
IList.Contains(Object)

Stabilisce se la raccolta StateManagedCollection contiene un valore specifico.Determines whether the StateManagedCollection collection contains a specific value.

(Ereditato da StateManagedCollection)
IList.IndexOf(Object)

Determina l'indice di un elemento specificato nella raccolta StateManagedCollection.Determines the index of a specified item in the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
IList.Insert(Int32, Object)

Inserisce un elemento nella raccolta StateManagedCollection in corrispondenza dell'indice specificato.Inserts an item into the StateManagedCollection collection at the specified index.

(Ereditato da StateManagedCollection)
IList.IsFixedSize

Ottiene un valore che indica se la dimensione della raccolta StateManagedCollection è fissa.Gets a value indicating whether the StateManagedCollection collection has a fixed size. Questo metodo restituisce false in tutti i casi.This method returns false in all cases.

(Ereditato da StateManagedCollection)
IList.IsReadOnly

Ottiene un valore che indica se la raccolta StateManagedCollection è di sola lettura.Gets a value indicating whether the StateManagedCollection collection is read-only.

(Ereditato da StateManagedCollection)
IList.Item[Int32]

Ottiene l'elemento IStateManager in corrispondenza dell'indice specificato.Gets the IStateManager element at the specified index.

(Ereditato da StateManagedCollection)
IList.Remove(Object)

Rimuove la prima occorrenza dell'oggetto specificato dalla raccolta StateManagedCollection.Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Ereditato da StateManagedCollection)
IList.RemoveAt(Int32)

Rimuove l'elemento IStateManager in corrispondenza dell'indice specificato.Removes the IStateManager element at the specified index.

(Ereditato da StateManagedCollection)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se la raccolta StateManagedCollection salva le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the StateManagedCollection collection is saving changes to its view state.

(Ereditato da StateManagedCollection)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione salvato in precedenza della raccolta StateManagedCollection e gli elementi IStateManager in essa contenuti.Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Ereditato da StateManagedCollection)
IStateManager.SaveViewState()

Salva le modifiche apportate alla raccolta StateManagedCollection e ogni oggetto IStateManager in essa contenuto dal momento in cui è stato eseguito il postback della pagina nel server.Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Ereditato da StateManagedCollection)
IStateManager.TrackViewState()

Fa in modo che la raccolta StateManagedCollection e ogni oggetto IStateManager in essa contenuto tenga traccia delle modifiche apportate al rispettivo stato di visualizzazione, in modo da consentirne il mantenimento nelle diverse richieste per la stessa pagina.Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page.

(Ereditato da StateManagedCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche