ViewCollection Classe

Definizione

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

Rappresenta un contenitore di raccolta che consente a un MultiView controllo 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 utilizzato 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 controlli figlio. Un MultiView controllo può contenere solo View controlli come controlli figlio.

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

Costruttori

Nome Descrizione
ViewCollection(Control)

Inizializza una nuova istanza della classe ViewCollection.

Proprietà

Nome Descrizione
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 View controllo in corrispondenza della posizione di indice specificata nell'insieme ViewCollection .
Owner

Ottiene l'ASP.NET controllo server a cui appartiene l'oggetto ControlCollection .

(Ereditato da ControlCollection)
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme di controlli.

(Ereditato da ControlCollection)

Metodi

Nome Descrizione
Add(Control)

Aggiunge il controllo specificato View alla raccolta.
AddAt(Int32, Control)

Aggiunge il controllo specificato View all'insieme in corrispondenza della posizione di indice specificata.
Clear()

Rimuove tutti i controlli dall'oggetto del ControlCollection controllo server corrente.

(Ereditato da ControlCollection)
Contains(Control)

Determina se il controllo server specificato si trova nell'oggetto del ControlCollection controllo server padre.

(Ereditato da ControlCollection)
CopyTo(Array, Int32)

Copia i controlli figlio archiviati nell'oggetto ControlCollection in un Array oggetto, a partire 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 in grado di scorrere l'oggetto ControlCollection .

(Ereditato da ControlCollection)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IndexOf(Control)

Recupera l'indice di un oggetto specificato Control nell'insieme.

(Ereditato da ControlCollection)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Remove(Control)

Rimuove il controllo server specificato dall'oggetto del ControlCollection controllo server padre.

(Ereditato da ControlCollection)
RemoveAt(Int32)

Rimuove un controllo figlio, in corrispondenza della 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

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.

Si applica a

Vedi anche