WebPartManager.DisplayMode Propriété

Référence

Définition

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

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.

Obtient ou définit le mode d'affichage actif pour une page Web qui contient des contrôles WebPart.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ DisplayMode { System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ get(); void set(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartDisplayMode DisplayMode { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayMode with get, set

Public Overridable Property DisplayMode As WebPartDisplayMode

Valeur de propriété

WebPartDisplayMode

WebPartDisplayMode qui détermine le mode d'affichage d'une page.

Attributs: BrowsableAttribute

Exceptions

ArgumentNullException

L'objet WebPartDisplayMode assigné à la propriété est null.

ArgumentException

L'objet WebPartDisplayMode assigné à la propriété n'est pas l'un des modes d'affichage pris en charge.

ou - L'objet WebPartDisplayMode assigné à la propriété est désactivé.

Exemples

L’exemple de code suivant illustre l’utilisation par programmation de la DisplayMode propriété. Après avoir chargé la page dans un navigateur, vous pouvez utiliser les boutons en bas de la page pour changer de mode d’affichage. La page est en mode parcourir par défaut lorsqu’elle se charge. Si vous passez en mode conception, vous pouvez faire glisser les contrôles serveur d’une zone vers une autre ou organiser deux contrôles dans une zone. Si vous basculez en mode édition, vous pouvez cliquer sur le menu verbes dans l’en-tête des contrôles serveur, sélectionner Modifier et modifier le contrôle à l’aide de l’interface utilisateur d’édition fournie.

Notes

Le basculement entre les modes d’affichage dans une application composants WebPart est très courant et vous pouvez fournir un moyen cohérent et réutilisable de procéder ainsi sur toutes vos pages qui contiennent des contrôles composants WebPart. Pour obtenir un exemple de contrôle utilisateur qui modifie les modes d’affichage et qui peut être réutilisé sur de nombreuses pages, consultez Procédure pas à pas : Modification des modes d’affichage sur une page composants WebPart.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  protected void Button1_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.DesignDisplayMode;
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.EditDisplayMode;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </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">
<script runat="server">

  
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.DesignDisplayMode
  End Sub
  
  Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.EditDisplayMode
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

Remarques

Une page qui contient composants WebPart contrôles est toujours dans l’un des différents modes d’affichage possibles. Pour plus d’informations sur les modes d’affichage, consultez composants WebPart Modes d’affichage de page.

La WebPartManager classe crée les modes d’affichage d’une page Web. À l’aide de la classe de baseWebPartDisplayMode, le WebPartManager contrôle crée plusieurs objets en mode affichage standard qui peuvent être utilisés sur des pages qui contiennent des contrôles composants WebPart. Ces modes d’affichage standard sont décrits dans la vue d’ensemble de la WebPartDisplayMode classe.

Le WebPartManager contrôle gère également les modes d’affichage des pages qui utilisent composants WebPart contrôles. À l’aide de la DisplayMode propriété, le WebPartManager contrôle conserve une référence au mode d’affichage actuel sur une page. Vous pouvez également utiliser la DisplayMode propriété pour basculer une page en différents modes d’affichage. Pour obtenir un exemple de modification des modes d’affichage sur une page qui utilise des contrôles composants WebPart, consultez Procédure pas à pas : Modification des modes d’affichage sur une page composants WebPart.

Dans le cadre de la gestion du mode d’affichage, le WebPartManager contrôle fournit également des événements et des gestionnaires d’événements relatifs aux modes d’affichage, tels que la OnDisplayModeChanged méthode et la OnDisplayModeChanging méthode. Ces méthodes fournissent un mécanisme permettant de personnaliser le comportement d’une page et même d’ajouter un mode d’affichage personnalisé.

S’applique à