Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

ViewCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente un conteneur de collection qui permet au contrôle MultiView de conserver une liste de ses contrôles enfants.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class ViewCollection : ControlCollection
public class ViewCollection extends ControlCollection
public class ViewCollection extends ControlCollection

La classe ViewCollection représente un conteneur de collection qui permet à un contrôle MultiView de conserver une liste de ses contrôles enfants. Un contrôle MultiView ne peut contenir que des contrôles View comme contrôles enfants.

Utilisez la méthode Add pour ajouter un nouveau contrôle View à la collection ViewCollection à la fin d'un tableau d'index ordinal. Utilisez la méthode AddAt pour ajouter un nouveau contrôle à une position d'index spécifique. Utilisez l'indexeur Item pour obtenir un contrôle View à partir de la collection ViewCollection située à un index spécifié, à l'aide d'une simple notation de tableau.

L'exemple de code suivant illustre comment ajouter par programme des contrôles View à un contrôle MultiView. Après avoir créé chaque contrôle View, la méthode AddAt est utilisée pour ajouter le contrôle View à la collection ViewCollection du contrôle MultiView à l'index spécifié. L'indexeur Item est utilisé pour accéder aux propriétés ID des contrôles View stockés dans la collection ViewCollection et pour les afficher à l'utilisateur.

<%@ Page Language="VB"%>
<html>
<head>

    <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"/>
        </asp:Button><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>

System.Object
   System.Web.UI.ControlCollection
    System.Web.UI.WebControls.ViewCollection

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft