Bibliothèque de classes .NET Framework
ViewCollection..::.Add, méthode

Mise à jour : novembre 2007

Ajoute le contrôle spécifié View à la collection.

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

Syntaxe

Visual Basic (Déclaration)
Public Overrides Sub Add ( _
    v As Control _
)
Visual Basic (Utilisation)
Dim instance As ViewCollection
Dim v As Control

instance.Add(v)
C#
public override void Add(
    Control v
)
VisualC++
public:
virtual void Add(
    Control^ v
) override
J#
public void Add(
    Control v
)
JScript
public override function Add(
    v : Control
)

Paramètres

v
Type : System.Web.UI..::.Control

Contrôle View à ajouter à la collection.

Exceptions

ExceptionCondition
ArgumentException

Le paramètre v ne spécifie pas de contrôle View.

Notes

La méthode Add ajoute le nouveau contrôle à la fin d'une zone d'index ordinal. Le contrôle peut uniquement être une instance d'un contrôle View.

Pour ajouter un contrôle à la collection à un emplacement d'index spécifique, utilisez la méthode AddAt.

Exemples

L'exemple de code suivant montre comment ajouter par programme des contrôles View à un contrôle MultiView. Après avoir créé chaque contrôle View, la syntaxe MultiView.Views.Add() est utilisée pour ajouter le contrôle View à la collection ViewCollection du contrôle MultiView.

Visual Basic
<%@ Page Language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<head>
    <title>ViewCollection Class Example</title>
<script runat="server">

        Sub Index_Changed(ByVal Sender As Object, ByVal e As EventArgs)
            ' A MultiView was added to the page declaratively.
            ' Now add the View control programmatically.            

            If SelectViewListBox.SelectedIndex >= 0 Then
                ' The user selected a view.
                ' Determine which view the user selected.

                Dim viewName As String = SelectViewListBox.SelectedItem.Text
                Dim myView as New View

                ' Use a helper function to create the view.
                myView = CreateView(viewName, "This is " + viewName)

                ' Add myView to the ViewCollection of the MultiView1 control.
                MultiView1.Views.Add(myView)

                ' Set myView as the active view.
                MultiView1.SetActiveView(myView)

                ' The Panel control was initially set to not visible.
                ' Set it to visible to add styles to the myView.
                Panel1.Visible=True

            Else
                Throw New Exception("You did not select a valid view.")

            End If

        End Sub

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

            ' Create a Label control.
            Dim Label1 As New Label

            ' Set the text property for the label.
            Label1.Text = viewDescription

            ' Add the label to the controls collection of the view.
            myView.Controls.Add(Label1)

            Return myView
        End Function

</script>

</head>
<body>

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

        <h3>ViewCollection Class Example</h3>

        <h4>Select a View to create and display in a MultiView control:</h4>

        <asp:ListBox ID="SelectViewListBox"
            AutoPostBack="True"
            Rows="1"
            SelectionMode="Single"
            OnSelectedIndexChanged="Index_Changed"
            runat="Server">
            <asp:ListItem Value="0">View1</asp:ListItem>
            <asp:ListItem Value="1">View2</asp:ListItem>
        </asp:ListBox><br /><br />

        <hr /><br /> 

        <asp:Panel ID="Panel1"
            Height="75px"
            Width="100px"
            Backcolor="Aqua"
            BorderStyle="Double" 
            Visible = "False"
            runat="Server"> 

            <asp:MultiView ID="MultiView1"
                runat="Server">
            </asp:MultiView>

        </asp:Panel>

    </form>

</body>
</html>
Plateformes

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Voir aussi

Référence

Mots clés :


Page view tracker