WebPartManager.DisplayMode Propriété

Définition

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 qui détermine le mode d'affichage d'une page.

Attributs

Exceptions

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

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 de navigation par défaut lors du chargement. Si vous basculez en mode conception, vous pouvez faire glisser les contrôles serveur d’une zone à 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 de l’un des contrôles serveur, sélectionner Modifier, puis modifier le contrôle à l’aide de l’interface utilisateur de modification fournie.

Notes

Le basculement entre les modes d’affichage dans une application de composants WebPart est très courant et vous pouvez fournir un moyen cohérent et réutilisable de le faire sur toutes vos pages qui contiennent des contrôles De 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 de 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 des contrôles WebPart est toujours dans l’un des différents modes d’affichage possibles. Pour plus d’informations sur les modes d’affichage, consultez Modes d’affichage des pages de composants WebPart.

La WebPartManager classe crée les modes d’affichage d’une page Web. À l’aide de la classe de base WebPartDisplayMode , le WebPartManager contrôle crée plusieurs objets en mode d’affichage standard qui peuvent être utilisés sur les pages qui contiennent des contrôles 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 des contrôles de composants WebPart. À 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 dans différents modes d’affichage. Pour obtenir un exemple de modification des modes d’affichage sur une page qui utilise des contrôles De composants WebPart, consultez Procédure pas à pas : modification des modes d’affichage sur une page de 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 à

Voir aussi