ViewCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 un contenitore di insiemi che consente a un controllo MultiView di mantenere un elenco dei relativi controlli figlio.

public ref class ViewCollection : System::Web::UI::ControlCollection

public class ViewCollection : System.Web.UI.ControlCollection

type ViewCollection = class
    inherit ControlCollection

Public Class ViewCollection
Inherits ControlCollection

Ereditarietà: Object

ControlCollection
ViewCollection

Esempio

Nell'esempio di codice seguente viene illustrato come aggiungere View controlli a livello di codice a un MultiView controllo . Dopo aver creato ogni View controllo, il AddAt metodo viene usato per aggiungere il View controllo alla ViewCollection raccolta del controllo in corrispondenza dell'indice MultiView specificato. L'indicizzatore Item[] viene usato per accedere alle ID proprietà dei View controlli archiviati nella ViewCollection raccolta e visualizzarli all'utente.

<%@ Page Language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ViewCollection example</title>
<script runat="server">
      
        Sub Button1_Click(ByVal Sender As Object, ByVal e As EventArgs)
            ' Create a MultiView control.
            Dim MultiView1 As New MultiView

            ' Create a ViewCollection for the View 
            ' controls contained in MultiView1.
            Dim myViewCollection As New ViewCollection(MultiView1)

            ' Create a View control. 
            Dim View1 As New View
            ' Use a helper function to create the view.
            View1 = CreateView("View1")
            ' Add View1 to myViewCollection at index 0.
            myViewCollection.AddAt(0, View1)

            ' Create a second View control and 
            ' add it to myViewCollection at index 1.
            Dim View2 As New View
            View2 = CreateView("View2")
            myViewCollection.AddAt(1, View2)

            ' Create a third View control and 
            ' add it to myViewCollection at index 0.
            ' Inserting View3 at index 0 
            ' causes View1 to move to index 1  
            ' and View2 to move to index 2.
            Dim View3 As New View
            View3 = CreateView("View3")
            myViewCollection.AddAt(0, View3)

            ' Show the contents of myViewCollection on the page.
            DisplayViewCollectionContents(myViewCollection)
            
        End Sub

        ' A function to programmatically create a View control.
        Private Function CreateView(ByVal viewId As String) As View
            ' Create a View control
            Dim myView As New View
            myView.ID = viewId

            ' Create a Panel control.
            Dim Panel1 As New Panel

            ' Set the style properties for Panel1.
            Panel1.Height = New Unit(150)
            Panel1.Width = New Unit(150)
            Panel1.BackColor = System.Drawing.Color.Azure
            Panel1.BorderStyle = BorderStyle.Double

            ' Add Panel1 to the Controls collection
            ' of the View control.
            myView.Controls.Add(Panel1)

            ' Create a Label control.
            Dim Label1 As New Label

            ' Set the properties for Label1.
            Label1.Text = "This is " + CStr(myView.ID)

            ' Add Label1 to the Controls collection
            ' of the Panel1 control.
            Panel1.Controls.Add(Label1)

            Return myView
        End Function

        ' A sub-routine to display the contents of myViewCollection.
        Sub DisplayViewCollectionContents(ByVal collection As ViewCollection)
            ' Use the Item property to access the ID of the View
            ' control at the specified index in the collection.
            Label1.Text = "The view at index 0 is " + collection.Item(0).ID
            Label2.Text = "The view at index 1 is " + collection.Item(1).ID
            Label3.Text = "The view at index 2 is " + collection.Item(2).ID
        End Sub

</script>
 
</head>
<body>

    <form id="Form1" runat="server">

        <h3>ViewCollection example</h3> 

        <asp:Button id="Button2" 
            Text="Show ViewCollection contents" 
            OnClick="Button1_Click" 
            runat="Server"/>
        <br /><br />  
        
        <hr />
  
        <asp:Label ID="Label1"
            runat="Server">
        </asp:Label><br /><br /> 

        <asp:Label ID="Label2"
            runat="Server">
        </asp:Label><br /><br />

        <asp:Label ID="Label3"
            runat="Server">
        </asp:Label><br /><br /> 
       
    </form>
   
</body>
</html>

Commenti

La ViewCollection classe rappresenta un contenitore di raccolta che consente a un MultiView controllo di mantenere un elenco dei relativi controlli figlio. Un MultiView controllo può contenere solo View controlli come controlli figlio.

Utilizzare il Add metodo per aggiungere un nuovo View controllo alla ViewCollection raccolta alla fine di una matrice di indici ordinali. Utilizzare il AddAt metodo per aggiungere un nuovo controllo in una posizione di indice specifica. Usare l'indicizzatore Item[] per ottenere un View controllo dalla ViewCollection raccolta in corrispondenza di un indice specificato, usando una semplice notazione di matrice.

Costruttori

ViewCollection(Control)

Inizializza una nuova istanza della classe ViewCollection.

Proprietà

Count	Ottiene il numero di controlli server nell'oggetto ControlCollection per il controllo server ASP.NET specificato. (Ereditato da ControlCollection)
IsReadOnly	Ottiene un valore che indica se l'oggetto ControlCollection è di sola lettura. (Ereditato da ControlCollection)
IsSynchronized	Ottiene un valore che indica se l'oggetto ControlCollection è sincronizzato. (Ereditato da ControlCollection)
Item[Int32]	Ottiene un riferimento al controllo View in corrispondenza della posizione dell'indice specificata nell'insieme ViewCollection.
Owner	Ottiene il controllo server ASP.NET cui l'oggetto ControlCollection appartiene. (Ereditato da ControlCollection)
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme dei controlli. (Ereditato da ControlCollection)

Metodi

Add(Control)	Aggiunge il controllo View all'insieme.
AddAt(Int32, Control)	Aggiunge il controllo View specificato all'insieme in corrispondenza della posizione di indice specificata.
Clear()	Rimuove tutti i controlli dall'oggetto ControlCollection del controllo server corrente. (Ereditato da ControlCollection)
Contains(Control)	Stabilisce se il controllo server specificato è presente nell'oggetto ControlCollection del controllo server padre. (Ereditato da ControlCollection)
CopyTo(Array, Int32)	Copia i controlli figlio memorizzati nell'oggetto ControlCollection in un oggetto Array, a cominciare dalla posizione di indice specificata in Array. (Ereditato da ControlCollection)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Recupera un enumeratore che consente di scorrere l'oggetto ControlCollection. (Ereditato da ControlCollection)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Control)	Recupera l'indice di un oggetto Control specificato nell'insieme. (Ereditato da ControlCollection)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(Control)	Rimuove il controllo server specificato dall'oggetto ControlCollection del controllo server padre. (Ereditato da ControlCollection)
RemoveAt(Int32)	Rimuove un controllo figlio, nella posizione di indice specificata, dall'oggetto ControlCollection. (Ereditato da ControlCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a