WebPartManager.DisplayMode Propiedad

Definición

Obtiene o establece el modo de presentación activo para una página Web que contiene controles de elementos Web.Gets or sets the active display mode for a Web page that contains Web Parts controls.

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

Valor de propiedad

WebPartDisplayMode

Objeto WebPartDisplayMode que determina el modo de presentación de una página.A WebPartDisplayMode that determines a page's display mode.

Atributos

Excepciones

El objeto WebPartDisplayMode que se asigna a la propiedad es null.The WebPartDisplayMode object being assigned to the property is null.

El objeto WebPartDisplayMode que se asigna a la propiedad no es ninguno de los modos de presentación compatibles.The WebPartDisplayMode object being assigned to the property is not one of the supported display modes.

o bien-or- El objeto WebPartDisplayMode que se asigna a la propiedad está deshabilitado.The WebPartDisplayMode object being assigned to the property is disabled.

Ejemplos

En el ejemplo de código siguiente se muestra el uso mediante programación de la DisplayMode propiedad.The following code example demonstrates programmatic use of the DisplayMode property. Después de cargar la página en un explorador, puede usar los botones situados cerca de la parte inferior de la página para cambiar los modos de visualización.After loading the page in a browser, you can use the buttons near the bottom of the page to switch display modes. La página está en modo de exploración de forma predeterminada cuando se carga.The page is in browse mode by default when it loads. Si cambia al modo de diseño, puede arrastrar los controles de servidor de una zona a otra, u organizar dos controles dentro de una zona.If you switch to design mode, you can drag the server controls from one zone to another, or arrange two controls within one zone. Si cambia al modo de edición, puede hacer clic en el menú de verbos en el encabezado de cualquiera de los controles de servidor, seleccionar Editar y editar el control con la interfaz de usuario (UI) de edición proporcionada.If you switch to edit mode, you can click the verbs menu in the header of either of the server controls, select Edit, and edit the control using the provided editing user interface (UI).

Nota

Cambiar entre modos de presentación en una aplicación elementos web es muy común y es posible que desee proporcionar una manera coherente y reutilizable para hacerlo en todas las páginas que contengan elementos web controles.Switching among display modes in a Web Parts application is very common, and you might want to provide a consistent, reusable way to do this on all your pages that contain Web Parts controls. Para obtener un ejemplo de un control de usuario que cambia los modos de presentación y que se puede reutilizar en muchas páginas, vea Tutorial: cambiar los modos de presentación en una página de elementos Web.For an example of a user control that changes display modes and that can be reused on many pages, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ 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>

Comentarios

Una página que contiene elementos web controles siempre está en uno de varios modos de visualización posibles.A page that contains Web Parts controls is always in one of several possible display modes. Para obtener más información sobre los modos de presentación, vea elementos Web modos de presentación de página.For details about display modes, see Web Parts Page Display Modes.

La WebPartManager clase crea los modos de presentación de una página web.The WebPartManager class creates the display modes for a Web page. Con la WebPartDisplayMode clase base, el WebPartManager control crea varios objetos de modo de presentación estándar que se pueden utilizar en las páginas que contienen controles elementos Web.Using the base WebPartDisplayMode class, the WebPartManager control creates several standard display mode objects that can be used on pages that contain Web Parts controls. Estos modos de presentación estándar se describen en la WebPartDisplayMode información general de la clase.These standard display modes are described in the WebPartDisplayMode class overview.

El WebPartManager control también administra los modos de presentación de las páginas que usan controles elementos Web.The WebPartManager control also manages the display modes for pages that use Web Parts controls. Mediante la DisplayMode propiedad, el WebPartManager control mantiene una referencia al modo de presentación actual en una página.Using the DisplayMode property, the WebPartManager control keeps a reference to the current display mode on a page. También puede utilizar la DisplayMode propiedad para cambiar una página a diferentes modos de presentación.You can also use the DisplayMode property to switch a page into different display modes. Para obtener un ejemplo de cómo cambiar los modos de presentación en una página que usa controles de elementos web, vea Tutorial: cambiar los modos de presentación en una página de elementos Web.For an example of changing display modes on a page that uses Web Parts controls, see Walkthrough: Changing Display Modes on a Web Parts Page.

Como parte de la administración del modo de presentación, el WebPartManager control también proporciona eventos y controladores de eventos relacionados con los modos de presentación, como el OnDisplayModeChanged método y el OnDisplayModeChanging método.As part of managing the display mode, the WebPartManager control also provides events and event handlers relating to display modes, such as the OnDisplayModeChanged method and the OnDisplayModeChanging method. Estos métodos proporcionan un mecanismo para personalizar el comportamiento de una página e incluso para agregar un modo de presentación personalizado.These methods provide a mechanism for customizing a page's behavior, and even for adding a custom display mode.

Se aplica a

Consulte también