Partager via


MultiView Classe

Définition

Représente un contrôle qui agit en tant que conteneur pour un groupe de View contrôles.

public ref class MultiView : System::Web::UI::Control
public class MultiView : System.Web.UI.Control
type MultiView = class
    inherit Control
Public Class MultiView
Inherits Control
Héritage
MultiView

Exemples

L’exemple de code suivant montre comment utiliser un MultiView contrôle pour créer une enquête de base. Chaque View contrôle est une question d’enquête distincte. Lorsque l’utilisateur clique sur le bouton Précédent sur n’importe quelle page, la ActiveViewIndex propriété est décrémentée pour accéder au contrôle précédent View . Lorsque l’utilisateur clique sur le bouton Suivant sur n’importe quelle page, la ActiveViewIndex propriété est incrémentée pour accéder au contrôle suivant View .

Note

Les exemples de code suivants utilisent le modèle de code à fichier unique et peuvent ne pas fonctionner correctement s’ils sont copiés directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.

<%@ Page Language="C#" %>

<!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>MultiView ActiveViewIndex Example</title>
<script runat="server">

  protected void NextButton_Command(object sender, EventArgs e)
  {
    // Determine which button was clicked
    // and set the ActiveViewIndex property to
    // the view selected by the user.
    if (DevPollMultiView.ActiveViewIndex > -1 & DevPollMultiView.ActiveViewIndex < 3)
    {
      // Increment the ActiveViewIndex property 
      // by one to advance to the next view.
      DevPollMultiView.ActiveViewIndex += 1;
    }
    else if (DevPollMultiView.ActiveViewIndex == 3)
    {
      // This is the final view.
      // The user wants to save the survey results.
      // Insert code here to save survey results.
      // Disable the navigation buttons.
      Page4Save.Enabled = false;
      Page4Restart.Enabled = false;
    }
    else
    {
      throw new Exception("An error occurred.");
    }
  }

  protected void BackButton_Command(object sender, EventArgs e)
  {
    if (DevPollMultiView.ActiveViewIndex > 0 & DevPollMultiView.ActiveViewIndex <= 2)
    {
      // Decrement the ActiveViewIndex property
      // by one to return to the previous view.
      DevPollMultiView.ActiveViewIndex -= 1;
    }
    else if (DevPollMultiView.ActiveViewIndex == 3)
    {
      // This is the final view.
      // The user wants to restart the survey.
      // Return to the first view.
      DevPollMultiView.ActiveViewIndex = 0;
    }
    else
    {
      throw new Exception("An error occurred.");
    }
  }

  </script>

</head>
<body>
    <form id="Form1" runat="Server">
        
        <h3>MultiView ActiveViewIndex Example</h3>
        
        <asp:Panel id="Page1ViewPanel" 
            Width="330px" 
            Height="150px"
            HorizontalAlign="Left"
            Font-size="12" 
            BackColor="#C0C0FF" 
            BorderColor="#404040"
            BorderStyle="Double"                     
            runat="Server">  

            <asp:MultiView id="DevPollMultiView"
                ActiveViewIndex="0"
                runat="Server">

                <asp:View id="Page1" 
                    runat="Server">   

                    <asp:Label id="Page1Label" 
                        Font-bold="true"                         
                        Text="What kind of applications do you develop?"
                        runat="Server"
                        AssociatedControlID="Page1">
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page1Radio1"
                         Text="Web Applications" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="server" >
                    </asp:RadioButton><br />

                    <asp:RadioButton id="Page1Radio2"
                         Text="Windows Forms Applications" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="server" >
                     </asp:RadioButton><br /><br /><br />                                       
                     
                    <asp:Button id="Page1Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat= "Server">
                    </asp:Button>     
                          
                </asp:View>

                <asp:View id="Page2" 
                    runat="Server">

                    <asp:Label id="Page2Label" 
                        Font-bold="true"                        
                        Text="How long have you been a developer?"
                        runat="Server"
                        AssociatedControlID="Page2">                    
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page2Radio1"
                         Text="Less than five years" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page2Radio2"
                         Text="More than five years" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br /><br /><br />

                    <asp:Button id="Page2Back"
                        Text = "Previous"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="70"
                        runat= "Server">
                    </asp:Button> 

                    <asp:Button id="Page2Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button> 
                
                </asp:View>

                <asp:View id="Page3" 
                    runat="Server">

                    <asp:Label id="Page3Label1" 
                        Font-bold="true"                        
                        Text= "What is your primary programming language?"                        
                        runat="Server"
                        AssociatedControlID="Page3">                    
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page3Radio1"
                         Text="Visual Basic .NET" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page3Radio2"
                         Text="C#" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page3Radio3"
                         Text="C++" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br /><br />

                     <asp:Button id="Page3Back"
                        Text = "Previous"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button> 

                    <asp:Button id="Page3Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button><br />
                    
                </asp:View>     
            
                <asp:View id="Page4"
                    runat="Server">
                    
                    <asp:Label id="Label1"
                        Font-bold="true"                                           
                        Text = "Thank you for taking the survey."
                        runat="Server"
                        AssociatedControlID="Page4">
                    </asp:Label>
                    
                    <br /><br /><br /><br /><br /><br />              
                   
                    <asp:Button id="Page4Save"
                        Text = "Save Responses"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="110"
                        runat="Server">
                    </asp:Button>
                
                    <asp:Button id="Page4Restart"
                        Text = "Retake Survey"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="110"
                        runat= "Server">
                    </asp:Button>                    
                    
                </asp:View>  
       
            </asp:MultiView>
        
        </asp:Panel> 

    </form>
</body>
</html>
<%@ 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>MultiView ActiveViewIndex Example</title>
<script runat="server">

        Sub NextButton_Command(sender As Object, e As System.EventArgs)
            ' Determine which button was clicked
            ' and set the ActiveViewIndex property to
            ' the view selected by the user.
            If (DevPollMultiView.ActiveViewIndex > -1) AND DevPollMultiView.ActiveViewIndex < 3 Then
                ' Increment the ActiveViewIndex property 
                ' by one to advance to the next view.
                DevPollMultiView.ActiveViewIndex += 1
            ElseIf DevPollMultiView.ActiveViewIndex = 3 Then
                ' This is the final view.
                ' The user wants to save the survey results.
                ' Insert code here to save survey results.
                ' Disable the navigation buttons.
                Page4Save.Enabled = False
                Page4Restart.Enabled = False
            Else
                Throw New Exception("An error occurred.")

            End If

        End Sub

        Sub BackButton_Command(ByVal sender As Object, ByVal e As System.EventArgs)
            If (DevPollMultiView.ActiveViewIndex > 0) And DevPollMultiView.ActiveViewIndex <= 2 Then
                ' Decrement the ActiveViewIndex property
                ' by one to return to the previous view.
                DevPollMultiView.ActiveViewIndex -= 1
            ElseIf DevPollMultiView.ActiveViewIndex = 3 Then
                ' This is the final view.
                ' The user wants to restart the survey.
                ' Return to the first view.
                DevPollMultiView.ActiveViewIndex = 0
            Else
                Throw New Exception("An error occurred.")

            End If

        End Sub

</script>

</head>
<body>
    <form id="Form1" runat="Server">
        
        <h3>MultiView ActiveViewIndex Example</h3>
        
        <asp:Panel id="Page1ViewPanel" 
            Width="330px" 
            Height="150px"
            HorizontalAlign ="Left"
            Font-size="12" 
            BackColor="#C0C0FF" 
            BorderColor="#404040"
            BorderStyle="Double"                     
            runat="Server">  

            <asp:MultiView id="DevPollMultiView"
                ActiveViewIndex="0"
                runat="Server">

                <asp:View id="Page1" 
                    runat="Server">   

                    <asp:Label id="Page1Label" 
                        Font-bold="true"                         
                        Text="What kind of applications do you develop?"
                        runat="Server"
                        AssociatedControlID="Page1">
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page1Radio1"
                         Text="Web Applications" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="server" >
                    </asp:RadioButton><br />

                    <asp:RadioButton id="Page1Radio2"
                         Text="Windows Forms Applications" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="server" >
                     </asp:RadioButton><br /><br /><br />                                       
                     
                    <asp:Button id="Page1Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat= "Server">
                    </asp:Button>     
                          
                </asp:View>

                <asp:View id="Page2" 
                    runat="Server">

                    <asp:Label id="Page2Label" 
                        Font-bold="true"                        
                        Text="How long have you been a developer?"
                        runat="Server"
                        AssociatedControlID="Page2">                    
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page2Radio1"
                         Text="Less than five years" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page2Radio2"
                         Text="More than five years" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br /><br /><br />

                    <asp:Button id="Page2Back"
                        Text = "Previous"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="70"
                        runat= "Server">
                    </asp:Button> 

                    <asp:Button id="Page2Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button> 
                
                </asp:View>

                <asp:View id="Page3" 
                    runat="Server">

                    <asp:Label id="Page3Label1" 
                        Font-bold="true"                        
                        Text= "What is your primary programming language?"                        
                        runat="Server"
                        AssociatedControlID="Page3">                    
                    </asp:Label><br /><br />

                    <asp:RadioButton id="Page3Radio1"
                         Text="Visual Basic .NET" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page3Radio2"
                         Text="C#" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br />

                    <asp:RadioButton id="Page3Radio3"
                         Text="C++" 
                         Checked="False" 
                         GroupName="RadioGroup1" 
                         runat="Server">
                     </asp:RadioButton><br /><br />

                     <asp:Button id="Page3Back"
                        Text = "Previous"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button> 

                    <asp:Button id="Page3Next"
                        Text = "Next"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="70"
                        runat="Server">
                    </asp:Button><br />
                    
                </asp:View>     
            
                <asp:View id="Page4"
                    runat="Server">
                    
                    <asp:Label id="Label1"
                        Font-bold="true"                                           
                        Text = "Thank you for taking the survey."
                        runat="Server"
                        AssociatedControlID="Page4">
                    </asp:Label>
                    
                    <br /><br /><br /><br /><br /><br />              
                   
                    <asp:Button id="Page4Save"
                        Text = "Save Responses"
                        OnClick="NextButton_Command"
                        Height="25"
                        Width="110"
                        runat="Server">
                    </asp:Button>
                
                    <asp:Button id="Page4Restart"
                        Text = "Retake Survey"
                        OnClick="BackButton_Command"
                        Height="25"
                        Width="110"
                        runat= "Server">
                    </asp:Button>                    
                    
                </asp:View>  
       
            </asp:MultiView>
        
        </asp:Panel> 

    </form>
</body>
</html>

L’exemple de code suivant montre comment créer un contrôle de base MultiView qui contient trois View contrôles. L’affichage sélectionné par l’utilisateur dans la zone de liste est défini sur l’affichage actif et affiché à l’utilisateur. Pour obtenir un exemple plus détaillé du MultiView contrôle, consultez les autres exemples de code fournis dans cette rubrique.

<%@ 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>MultiView Class Example</title>
<script runat="server">

        Sub Index_Changed(ByVal Sender As Object, ByVal e As EventArgs)
            ' Set the active view to
            ' the view selected by the user.
            Dim text As String = ViewListBox.SelectedItem.Text
            Select Case (text)
                Case "View1"
                    MultiView1.SetActiveView(View1)
                Case "View2"
                    MultiView1.SetActiveView(View2)
                Case "View3"
                    MultiView1.SetActiveView(View3)
                Case Else
                    Throw New Exception("You did not select a valid view.")
            End Select

        End Sub

    </script>
</head>
<body>
    <form id="Form1" runat="server">
        
        <h3>MultiView Class Example</h3>
        
        <h4>Select a View to display in a MultiView control:</h4>

        <asp:ListBox id="ViewListBox" 
            Rows="1"
            SelectionMode="Single"
            AutoPostBack="True"
            OnselectedIndexChanged="Index_Changed"
            runat="Server">             
                <asp:ListItem Value="0">View1</asp:ListItem>
                <asp:ListItem Value="1">View2</asp:ListItem>
                <asp:ListItem Value="2">View3</asp:ListItem>
        </asp:ListBox><br /><br />
       
        <hr />

        <asp:MultiView id="MultiView1"
            runat="Server">

            <asp:View id="View1" 
                runat="Server">              
                    <asp:Label id="View1Label" 
                        Font-bold="true"
                        Font-size="14" 
                        Text="This is the content for View1."
                        runat="Server"
                        AssociatedControlID="View1">
                    </asp:Label>               
            </asp:View>
            
            <asp:View id="View2" 
                runat="Server">              
                    <asp:Label id="View2Label" 
                        Font-bold="true"
                        Font-size="14" 
                        Text="This is the content for View2."
                        runat="Server"
                        AssociatedControlID="View2">
                    </asp:Label>               
            </asp:View>
            
            <asp:View id="View3" 
                runat="Server">              
                    <asp:Label id="View3Label" 
                        Font-bold="true"
                        Font-size="14" 
                        Text="This is the content for View3."
                        runat="Server"
                        AssociatedControlID="View3">
                    </asp:Label>               
            </asp:View>

        </asp:MultiView>

    </form>
</body>
</html>

L’exemple de code suivant montre comment créer un MultiView contrôle qui contient trois View contrôles. Un View contrôle n’a aucune propriété de style. Par conséquent, chaque View contrôle contient un Panel contrôle pour permettre la définition de styles sur le View contrôle. La première fois que la page est chargée, elle DefaultView est définie en tant qu’affichage actif à l’aide de la SetActiveView méthode. Chaque View contrôle contient des boutons de lien pour permettre à l’utilisateur d’accéder à différentes vues.

<%@ 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>MultiView Class Example</title>
<script runat="server">

        Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
            ' The first time the page loads,
            ' render the DefaultView.
            If Not IsPostBack Then
                ' Set DefaultView as the active view.
                MultiView1.SetActiveView(DefaultView)
            End If

        End Sub

        Sub LinkButton_Command(sender As Object, e As System.Web.UI.WebControls.CommandEventArgs)
            ' Determine which link button was clicked
            ' and set the active view to
            ' the view selected by the user.
            Select Case (e.CommandArgument)
                Case "DefaultView"
                    MultiView1.SetActiveView(DefaultView)
                Case "News"
                    MultiView1.SetActiveView(NewsView)
                Case "Shopping"
                    MultiView1.SetActiveView(ShoppingView)
                Case Else
                    Throw New Exception("You did not select a valid list item.")

            End Select

        End Sub

</script>

</head>
<body>
    <form id="Form1" runat="server">
        
        <h3>MultiView Class Example</h3>

        <asp:MultiView id="MultiView1"
            runat="Server">

            <asp:View id="DefaultView" 
                runat="Server">                

                <asp:Panel id="DefaultViewPanel" 
                    Width="330px" 
                    BackColor="#C0C0FF" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">  

                    <asp:Label id="DefaultLabel1" 
                        Font-bold="true"
                        Font-size="14" 
                        Text="The Default View"
                        runat="Server"
                        AssociatedControlID="DefaultView">
                    </asp:Label>                  

                    <asp:BulletedList id="DefaultBulletedList1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Today's Weather</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Stock Quotes</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's News Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Featured Shopping</asp:ListItem>
                    </asp:BulletedList>

                    <hr />

                    <asp:Label id="DefaultLabel2"                      
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br />
                
                    <asp:LinkButton id="Default_NewsLink" 
                        Text="Go to News View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="News" 
                        CommandName="Link"
            Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="Default_ShoppingLink"
                        Text="Go to Shopping View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="Shopping" 
                        CommandName="Link"
            Width="150px"
                        runat="server">
                    </asp:LinkButton><br /><br />

                </asp:Panel>

            </asp:View>

            <asp:View id="NewsView" 
                runat="Server">

                <asp:Panel id="NewsPanel1" 
                    Width="330px" 
                    BackColor="#C0FFC0" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">

                    <asp:Label id="NewsLabel1" 
                        Font-bold="true"
                        Font-size="14"
                        Text="The News View"
                        runat="Server"
                        AssociatedControlID="NewsView">                    
                    </asp:Label>

                    <asp:BulletedList id="NewsBulletedlist1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Today's International Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's National Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Local News</asp:ListItem>
                    </asp:BulletedList>

                    <hr />

                    <asp:Label id="NewsLabel2"                      
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br />

                    <asp:LinkButton id="News_DefaultLink" 
                        Text="Go to the Default View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="DefaultView" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="News_ShoppingLink" 
                        Text="Go to Shopping View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="Shopping" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton><br /><br />

                </asp:Panel>

            </asp:View>

            <asp:View id="ShoppingView" 
                runat="Server">

                <asp:Panel id="ShoppingPanel1" 
                    Width="330px" 
                    BackColor="#FFFFC0" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">

                    <asp:Label id="ShoppingLabel1" 
                        Font-Bold="true"
                        Font-size="14"                         
                        Text="The Shopping View"
                        runat="Server"
                        AssociatedControlID="ShoppingView">
                    </asp:Label>

                    <asp:BulletedList id="ShoppingBulletedlist1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Home and Garden </asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Women's Fashions</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Men's Fashions</asp:ListItem>
                    </asp:BulletedList>

                    <hr />

                    <asp:Label id="ShoppingLabel2" 
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br />

                    <asp:LinkButton id="Shopping_DefaultLink" 
                        Text="Go to the Default View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="DefaultView" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="Shopping_NewsLink"
                        Text="Go to News View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="News" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton><br /><br />

                </asp:Panel>

            </asp:View>

        </asp:MultiView>

    </form>
</body>
</html>

Remarques

Dans cette rubrique :

Présentation

Le MultiView contrôle est un conteneur pour un groupe de View contrôles. Il vous permet de définir un groupe de View contrôles, où chaque View contrôle contient des contrôles enfants. Votre application peut ensuite restituer un contrôle spécifique View au client en fonction de critères tels que l’identité de l’utilisateur, les préférences utilisateur et les informations transmises dans un paramètre de chaîne de requête. Vous pouvez également utiliser le MultiView contrôle pour créer des Assistants. Dans ce scénario, chaque View contrôle contenu dans un MultiView contrôle représente une étape ou une page différente dans l’Assistant. Vous devez également utiliser ce contrôle pour développer des applications à écran multiple pour les appareils mobiles. Ce contrôle fournit les mêmes fonctionnalités que le contrôle mobile Form ASP.NET dans .NET Framework version 1.1.

View Un seul contrôle à la fois peut être défini comme vue active dans un MultiView contrôle. Lorsqu’un View contrôle est défini comme vue active, les contrôles enfants qu’il contient sont rendus au client. Vous pouvez utiliser la propriété ou la ActiveViewIndexSetActiveView méthode pour définir l’affichage actif. Si la ActiveViewIndex propriété est vide, le MultiView contrôle n’affiche aucun contenu sur le client. Si l’affichage actif est défini sur un View élément qui n’existe pas dans le contrôle, un ArgumentOutOfRangeException élément est déclenché au moment de l’exécutionMultiView.

Vous pouvez définir l’affichage actif de manière déclarative ou programmatique. La définition de la ActiveViewIndex propriété de manière déclarative lorsque vous définissez le MultiView contrôle entraîne l’appel View du contrôle défini comme affichage actif pour le client la première fois que le MultiView contrôle est appelé. L’exemple de code suivant montre comment définir la ActiveViewIndex propriété de manière déclarative.

<asp:MultiView id="MultiView1" ActiveViewIndex=0 runat="Server">

La définition de la ActiveViewIndex propriété par programmation ou l’appel de la SetActiveView méthode permet à l’application de déterminer le View contrôle à restituer au client au moment de l’exécution en fonction de critères tels que l’identité ou les préférences d’un utilisateur.

Pour permettre aux utilisateurs de naviguer entre View les contrôles au sein d’un MultiView contrôle, vous pouvez ajouter un ou Button un LinkButton contrôle à chaque View contrôle. Pour tirer parti de la MultiView mise à jour automatique du Viewcontrôle actif, définissez la CommandName propriété sur le bouton ou le bouton de lien sur la valeur de l’un des champs de nom de commande suivants correspondant au comportement de navigation souhaité : PreviousViewCommandName, , NextViewCommandNameSwitchViewByIDCommandNameou SwitchViewByIndexCommandName.

Syntaxe déclarative

<asp:MultiView
    ActiveViewIndex="integer"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnActiveViewChanged="ActiveViewChanged event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Visible="True|False"
>
            <asp:TemplatedWizardStep
                AllowReturn="True|False"
                ContentTemplateContainer="string"
                EnableTheming="True|False"
                EnableViewState="True|False"
                ID="string"
                OnActivate="Activate event handler"
                OnDataBinding="DataBinding event handler"
                OnDeactivate="Deactivate event handler"
                OnDisposed="Disposed event handler"
                OnInit="Init event handler"
                OnLoad="Load event handler"
                OnPreRender="PreRender event handler"
                OnUnload="Unload event handler"
                runat="server"
                SkinID="string"
                StepType="Auto|Complete|Finish|Start|Step"
                Title="string"
                Visible="True|False"
>
                        <ContentTemplate>
                            <!-- child controls -->
                        </ContentTemplate>
                        <CustomNavigationTemplate>
                            <!-- child controls -->
                        </CustomNavigationTemplate>
            </asp:TemplatedWizardStep>
            <asp:View
                EnableTheming="True|False"
                EnableViewState="True|False"
                ID="string"
                OnActivate="Activate event handler"
                OnDataBinding="DataBinding event handler"
                OnDeactivate="Deactivate event handler"
                OnDisposed="Disposed event handler"
                OnInit="Init event handler"
                OnLoad="Load event handler"
                OnPreRender="PreRender event handler"
                OnUnload="Unload event handler"
                runat="server"
                SkinID="string"
                Visible="True|False"
            />
            <asp:WizardStep
                AllowReturn="True|False"
                EnableTheming="True|False"
                EnableViewState="True|False"
                ID="string"
                OnActivate="Activate event handler"
                OnDataBinding="DataBinding event handler"
                OnDeactivate="Deactivate event handler"
                OnDisposed="Disposed event handler"
                OnInit="Init event handler"
                OnLoad="Load event handler"
                OnPreRender="PreRender event handler"
                OnUnload="Unload event handler"
                runat="server"
                SkinID="string"
                StepType="Auto|Complete|Finish|Start|Step"
                Title="string"
                Visible="True|False"
            />
</asp:MultiView>

Constructeurs

Nom Description
MultiView()

Initialise une nouvelle instance de la classe MultiView.

Champs

Nom Description
NextViewCommandName

Représente le nom de commande associé au contrôle suivant View à afficher dans un MultiView contrôle. Ce champ est en lecture seule.

PreviousViewCommandName

Représente le nom de commande associé au contrôle précédent View à afficher dans un MultiView contrôle. Ce champ est en lecture seule.

SwitchViewByIDCommandName

Représente le nom de commande associé à la modification du contrôle actif View dans un MultiView contrôle, en fonction d’un ID spécifié View . Ce champ est en lecture seule.

SwitchViewByIndexCommandName

Représente le nom de commande associé à la modification du contrôle actif View dans un contrôle en fonction d’un MultiView index spécifié View . Ce champ est en lecture seule.

Propriétés

Nom Description
ActiveViewIndex

Obtient ou définit l’index du contrôle actif View dans un MultiView contrôle.

Adapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle.

(Hérité de Control)
BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
ChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété.

(Hérité de Control)
Context

Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle.

(Hérité de Control)
Controls

Obtient un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.

(Hérité de Control)
DataItemContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente .

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente .

(Hérité de Control)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception.

(Hérité de Control)
EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s’appliquent au MultiView contrôle.

EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés.

(Hérité de Control)
ID

Obtient ou définit l’identificateur programmatique affecté au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer les identificateurs de contrôle.

(Hérité de Control)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle.

(Hérité de Control)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.

(Hérité de Control)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.

(Hérité de Control)
Page

Obtient une référence à l’instance Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible.

(Hérité de Control)
Site

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception.

(Hérité de Control)
SkinID

Obtient ou définit la peau à appliquer au contrôle.

(Hérité de Control)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du PageUserControl ou qui contient le contrôle serveur actuel.

(Hérité de Control)
UniqueID

Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur.

(Hérité de Control)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses.

(Hérité de Control)
Views

Obtient la collection de View contrôles dans le MultiView contrôle.

ViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)

Méthodes

Nom Description
AddedControl(Control, Int32)

Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control .

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le MultiView contrôle qu’un élément XML ou HTML a été analysé et ajoute l’élément à la ViewCollection collection du MultiView contrôle.

ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Définit la valeur mise en ClientID cache sur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit.

(Hérité de Control)
CreateChildControls()

Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu.

(Hérité de Control)
CreateControlCollection()

Crée un ControlCollection pour contenir les contrôles enfants du MultiView contrôle.

DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

(Hérité de Control)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding .

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
Dispose()

Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au suivi au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.

(Hérité de Control)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FindControl(String, Int32)

Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié id et spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode.

(Hérité de Control)
FindControl(String)

Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .

(Hérité de Control)
Focus()

Définit le focus d’entrée sur un contrôle.

(Hérité de Control)
GetActiveView()

Retourne le contrôle actif View actuel dans un MultiView contrôle.

GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur contient uniquement du contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Charge l’état actuel du MultiView contrôle.

LoadViewState(Object)

Restaure les informations d’état d’affichage à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode.

(Hérité de Control)
MapPathSecure(String)

Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnActiveViewChanged(EventArgs)

Déclenche l’événement ActiveViewChanged d’un MultiView contrôle.

OnBubbleEvent(Object, EventArgs)

Détermine si l’événement du MultiView contrôle est passé à la hiérarchie de contrôle du serveur d’interface utilisateur de la page.

OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnInit(EventArgs)

Déclenche l’événement Init.

OnLoad(EventArgs)

Déclenche l’événement Load.

(Hérité de Control)
OnPreRender(EventArgs)

Déclenche l’événement PreRender.

(Hérité de Control)
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream élément utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Affecte toutes les sources de l’événement et ses informations au parent du contrôle.

(Hérité de Control)
RemovedControl(Control)

Appelé après la suppression d’un View contrôle de la Controls collection d’un MultiView contrôle.

Render(HtmlTextWriter)

Écrit le contenu du MultiView contrôle dans l’objet spécifié HtmlTextWriter , pour l’affichage sur le client.

RenderChildren(HtmlTextWriter)

Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter .

(Hérité de Control)
RenderControl(HtmlTextWriter)

Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé.

(Hérité de Control)
ResolveAdapter()

Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL utilisable sur le client demandeur.

(Hérité de Control)
SaveControlState()

Enregistre l’état actuel du MultiView contrôle.

SaveViewState()

Enregistre les modifications de l’état d’affichage du contrôle de serveur qui se sont produites depuis la publication de la page sur le serveur.

(Hérité de Control)
SetActiveView(View)

Définit le contrôle spécifié View sur l’affichage actif dans un MultiView contrôle.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetRenderMethodDelegate(RenderMethod)

Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
TrackViewState()

Provoque le suivi des modifications d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. Cet objet est accessible via la ViewState propriété.

(Hérité de Control)

Événements

Nom Description
ActiveViewChanged

Se produit lorsque le contrôle actif View d’un MultiView contrôle change entre les publications sur le serveur.

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
Disposed

Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie.

(Hérité de Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l’objet Page .

(Hérité de Control)
PreRender

Se produit après le chargement de l’objet Control , mais avant le rendu.

(Hérité de Control)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

Nom Description
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)

Méthodes d’extension

Nom Description
FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l’objet métatable pour le contrôle de données contenant.

S’applique à

Voir aussi