Vue d'ensemble des contrôles serveur Web MultiView et View

Mise à jour : novembre 2007

Les contrôles serveur Web MultiView et View agissent en tant que conteneurs d'autres contrôles et de balisage et permettent de présenter facilement d'autres affichages d'informations.

Cette rubrique contient les sections suivantes :

  • Scénarios

  • Contexte

  • Exemples de code

  • Référence de classe

Scénarios

Vous pouvez utiliser les contrôles MultiView et View pour exécuter entre autres les tâches suivantes :

  • fournir d'autres ensembles de contrôles en fonction du choix de l'utilisateur ou d'autres conditions. Par exemple, vous pouvez autoriser les utilisateurs à choisir parmi une liste d'alimentations, chacune d'elle étant configurée dans un contrôle View distinct. Vous pouvez ensuite afficher le contrôle View qui contient les alimentations choisies par l'utilisateur. Les contrôles MultiView et View permettent également de créer de nombreux contrôles Panel ;

  • créer un formulaire composé de plusieurs pages. Les contrôles MultiView et View peuvent fournir un comportement similaire au contrôle Wizard. Le contrôle Wizard convient particulièrement à la création de formulaires que les utilisateurs remplissent étape par étape. Le contrôle Wizard fournit également une prise en charge pour plusieurs éléments d'interface intégrés (par exemple les en-têtes et les pieds de page), pour les boutons Précédent et Suivant et pour les modèles. Vous pouvez utiliser un contrôle MultiView à la place d'un Wizard si vous vouliez créer un affichage qui était modifié en fonction d'une condition (et non de manière séquentielle) ou si vous n'aviez pas besoin des fonctionnalités supplémentaires prises en charge par le contrôle Wizard.

Retour au début

Contexte

Le contrôle MultiView agit comme un conteneur externe d'un ou de plusieurs contrôles View. Les contrôles View peuvent, à leur tour, contenir toutes les combinaisons de balisage et de contrôles.

Le contrôle MultiView affiche un seul contrôle View à la fois, en exposant le balisage et les contrôles dans le contrôle View. En définissant la propriété ActiveViewIndex du contrôle MultiView, vous pouvez déterminer le contrôle View actuellement visible.

Affichage du contenu du contrôle View

Si un contrôle View n'est pas sélectionné, il ne s'affiche pas sur la page. Toutefois, les instances de tous les contrôles serveur Web contenues dans tous les contrôles View sont créées chaque fois que la page est affichée et leurs valeurs sont stockées dans l'état d'affichage de la page.

Ni le contrôle MultiView, ni les contrôles View individuels n'affichent de balisage sur la page, excepté le contenu du contrôle View actuel. Par exemple, les contrôles n'affichent pas d'élément div de la même manière qu'un contrôle Panel. Ils ne prennent pas en charge non plus les propriétés d'apparence qui peuvent être appliquées d'une manière générale au contrôle View actuel. Mais vous pouvez affecter un thème aux contrôles MultiView ou View qui appliquent le thème à tous les contrôles enfants du contrôle View actuel.

Références aux contrôles

Chaque contrôle View prend en charge une propriété Controls qui contient une collection de contrôles dans le contrôle View. Vous pouvez également référencer individuellement dans le code les contrôles dans les contrôles View. Pour plus d'informations, consultez Accès par programme aux contrôles ASP.NET.

Vous pouvez vous déplacer entre les affichages en affectant à la propriété ActiveViewIndex du contrôle MultiView la valeur d'index du contrôle View à afficher. Le contrôle MultiView inclut également la prise en charge des boutons de navigation que vous pouvez ajouter à chaque contrôle View.

Pour créer des boutons de navigation, vous pouvez ajouter un contrôle bouton (Button, LinkButtonou ImageButton) à chaque contrôle View. Vous pouvez affecter ensuite des valeurs réservées aux propriétés CommandName et CommandArgument de chaque bouton pour que le contrôle MultiView passe à un autre affichage. Le tableau suivant répertorie les valeurs CommandName réservées et les valeurs CommandArgument correspondantes.

Valeur CommandName

Valeur CommandArgument

NextView

(aucune valeur)

PrevView

(aucune valeur)

SwitchViewByID

ID du contrôle View vers lequel se déplacer.

SwitchViewByIndex

Numéro d'index du contrôle View vers lequel se déplacer.

L'exemple de code suivant affiche un contrôle MultiView avec trois contrôles View. Chaque contrôle View contient un contrôle Button qui se déplace vers un contrôle View spécifique.

<asp:MultiView ID="MultiView1"  ActiveViewIndex="0">
  <asp:View ID="View1" >
    View 1<br />
    <br />
    <asp:Button ID="Button1"  
      CommandArgument="View2" 
      CommandName="SwitchViewByID"
      Text="Go to View2" />
  </asp:View>
  <asp:View ID="View2" >
    View 2<br />
    <br />
    <asp:Button ID="Button2"  
      CommandArgument="View3" 
      CommandName="SwitchViewByID"
      Text="Go to View 3" />
  </asp:View>
  <asp:View ID="View3" >
    View 3<br />
    <br />
    <asp:Button ID="Button3"  
      CommandArgument="View1" 
      CommandName="SwitchViewByID"
      Text="Go to View 1" />
  </asp:View>
</asp:MultiView>

Retour au début

Exemples de code

Comment : ajouter des contrôles serveur Web MultiView à une page Web Forms (Visual Studio)

Retour au début

Référence de classe

Le tableau suivant répertorie les classes relatives aux contrôles MultiView et View.

Membre

Description

MultiView

Classe principale du contrôle MultiView.

ViewCollection

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

View

Classe principale du contrôle View.

MultiViewControlBuilder

Interagit avec l'analyseur pour générer un contrôle MultiView. Pour créer un générateur de contrôle personnalisé pour un contrôle dérivé MultiView, vous devez hériter de cette classe.

Retour au début

Voir aussi

Référence

Vue d'ensemble du contrôle serveur Web Panel

Vue d'ensemble du contrôle serveur Web Wizard