ViewCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

Héritage: Object

ControlCollection
ViewCollection

Exemples

L’exemple de code suivant montre comment ajouter View par programmation des contrôles à un MultiView contrôle. Une fois chaque View contrôle créé, la AddAt méthode est utilisée pour ajouter le View contrôle à la ViewCollection collection du contrôle à l’index MultiView spécifié. L’indexeur Item[] est utilisé pour accéder ID aux propriétés des View contrôles stockés dans la ViewCollection collection et les afficher à l’utilisateur.

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

Remarques

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

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

Constructeurs

ViewCollection(Control)

Initialise une nouvelle instance de la classe ViewCollection.

Propriétés

Count	Obtient le nombre de contrôles serveur dans l'objet ControlCollection pour le contrôle serveur ASP.NET spécifié. (Hérité de ControlCollection)
IsReadOnly	Obtient une valeur indiquant si l’objet ControlCollection est en lecture seule. (Hérité de ControlCollection)
IsSynchronized	Obtient une valeur indiquant si l'objet ControlCollection est synchronisé. (Hérité de ControlCollection)
Item[Int32]	Obtient une référence au contrôle View à l'emplacement d'index spécifié dans la collection ViewCollection.
Owner	Obtient le contrôle serveur ASP.NET auquel l'objet ControlCollection appartient. (Hérité de ControlCollection)
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection de contrôles. (Hérité de ControlCollection)

Méthodes

Add(Control)	Ajoute le contrôle spécifié View à la collection.
AddAt(Int32, Control)	Ajoute le contrôle spécifié View à la collection à l'emplacement d'index spécifié.
Clear()	Supprime tous les contrôles de l'objet ControlCollection du contrôle serveur en cours. (Hérité de ControlCollection)
Contains(Control)	Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent. (Hérité de ControlCollection)
CopyTo(Array, Int32)	Copie les contrôles enfants stockés dans l'objet ControlCollection vers un objet Array, en commençant à l'emplacement d'index spécifié dans Array. (Hérité de ControlCollection)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Récupère un énumérateur qui peut effectuer une itération au sein de l'objet ControlCollection. (Hérité de ControlCollection)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Control)	Récupère l'index d'un objet Control spécifié dans la collection. (Hérité de ControlCollection)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Control)	Supprime le contrôle serveur spécifié de l'objet ControlCollection du contrôle serveur parent. (Hérité de ControlCollection)
RemoveAt(Int32)	Supprime un contrôle enfant de l'objet ControlCollection, à l'emplacement d'index spécifié. (Hérité de ControlCollection)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à

Partager via