ViewCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Auflistungscontainer dar, mit dem ein MultiView-Steuerelement eine Liste untergeordneter Steuerelemente verwalten kann.

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

Vererbung: Object

ControlCollection
ViewCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie einem MultiView Steuerelement programmgesteuert Steuerelemente hinzugefügt werdenView. Nachdem jedes View Steuerelement erstellt wurde, wird die AddAt -Methode verwendet, um das View Steuerelement der ViewCollection Auflistung des MultiView Steuerelements am angegebenen Index hinzuzufügen. Der Item[] Indexer wird verwendet, um auf die ID Eigenschaften der View in der ViewCollection Auflistung gespeicherten Steuerelemente zuzugreifen und sie dem Benutzer anzuzeigen.

<%@ 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>

Hinweise

Die ViewCollection -Klasse stellt einen Auflistungscontainer dar, mit dem ein MultiView Steuerelement eine Liste seiner untergeordneten Steuerelemente verwalten kann. Ein MultiView Steuerelement darf nur View Steuerelemente als untergeordnete Steuerelemente enthalten.

Verwenden Sie die Add -Methode, um der ViewCollection Auflistung am Ende eines Ordnungsindexarrays ein neues View Steuerelement hinzuzufügen. Verwenden Sie die AddAt -Methode, um ein neues Steuerelement an einem bestimmten Indexspeicherort hinzuzufügen. Verwenden Sie den Item[] Indexer, um ein View Steuerelement aus der ViewCollection Auflistung zu einem angegebenen Index mithilfe einer einfachen Arraynotation abzurufen.

Konstruktoren

ViewCollection(Control)

Initialisiert eine neue Instanz der ViewCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Serversteuerelemente im ControlCollection-Objekt für das angegebene ASP.NET-Serversteuerelement ab. (Geerbt von ControlCollection)
IsReadOnly	Ruft einen Wert ab, der angibt, ob das ControlCollection schreibgeschützt ist. (Geerbt von ControlCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt synchronisiert ist. (Geerbt von ControlCollection)
Item[Int32]	Ruft einen Verweis auf das View-Steuerelement an der angegebenen Indexposition in der ViewCollection-Auflistung ab.
Owner	Ruft das ASP.NET-Serversteuerelement ab, zu dem das ControlCollection-Objekt gehört (Geerbt von ControlCollection)
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kann (Geerbt von ControlCollection)

Methoden

Add(Control)	Fügt der Auflistung das angegebene View-Steuerelement hinzu.
AddAt(Int32, Control)	Fügt das angegebene View-Steuerelement an der angegebenen Indexposition in die Auflistung ein.
Clear()	Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements. (Geerbt von ControlCollection)
Contains(Control)	Bestimmt, ob sich das angegebene Serversteuerelement im ControlCollection-Objekt des übergeordneten Serversteuerelements befindet (Geerbt von ControlCollection)
CopyTo(Array, Int32)	Kopiert die im ControlCollection-Objekt gespeicherten untergeordneten Steuerelemente in ein Array-Objekt. Dabei wird mit der angegebenen Indexposition im Array begonnen. (Geerbt von ControlCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Ruft einen Enumerator ab, der das ControlCollection-Objekt durchlaufen kann. (Geerbt von ControlCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Control)	Ruft den Index eines angegebenen Control-Objekts in der Auflistung ab (Geerbt von ControlCollection)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(Control)	Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten Serversteuerelements (Geerbt von ControlCollection)
RemoveAt(Int32)	Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection-Objekt (Geerbt von ControlCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für: