WebPartManager.DisplayMode Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o modo de exibição ativo para uma página da Web que contém controles Web Part.

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 da propriedade

WebPartDisplayMode

Um WebPartDisplayMode que determina o modo de exibição de uma página.

Atributos: BrowsableAttribute

Exceções

ArgumentNullException

O objeto WebPartDisplayMode que está sendo atribuído à propriedade é null.

ArgumentException

O objeto WebPartDisplayMode que está sendo atribuído à propriedade não é um dos modos de exibição com suporte.

- ou - O objeto WebPartDisplayMode que está sendo atribuído à propriedade está desabilitado.

Exemplos

O exemplo de código a seguir demonstra o uso programático da DisplayMode propriedade. Depois de carregar a página em um navegador, você pode usar os botões próximos à parte inferior da página para alternar os modos de exibição. A página está no modo de navegação por padrão quando é carregada. Se você alternar para o modo de design, poderá arrastar os controles do servidor de uma zona para outra ou organizar dois controles dentro de uma zona. Se você alternar para o modo de edição, poderá clicar no menu de verbos no cabeçalho de qualquer um dos controles do servidor, selecionar Editar e editar o controle usando a interface do usuário (interface do usuário) de edição fornecida.

Observação

Alternar entre modos de exibição em um aplicativo Web Parts é muito comum e talvez você queira fornecer uma maneira consistente e reutilizável de fazer isso em todas as suas páginas que contêm controles Web Parts. Para obter um exemplo de um controle de usuário que altera os modos de exibição e que pode ser reutilizado em muitas páginas, consulte Passo a passo: Alterando modos de exibição em uma página Web Parts.

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

Comentários

Uma página que contém controles Web Parts está sempre em um dos vários modos de exibição possíveis. Para obter detalhes sobre modos de exibição, consulte Web Parts Modos de Exibição de Página.

A WebPartManager classe cria os modos de exibição para uma página da Web. Usando a classe baseWebPartDisplayMode, o WebPartManager controle cria vários objetos de modo de exibição padrão que podem ser usados em páginas que contêm controles Web Parts. Esses modos de exibição padrão são descritos na visão geral da WebPartDisplayMode classe.

O WebPartManager controle também gerencia os modos de exibição para páginas que usam controles Web Parts. Usando a DisplayMode propriedade, o WebPartManager controle mantém uma referência ao modo de exibição atual em uma página. Você também pode usar a DisplayMode propriedade para alternar uma página para modos de exibição diferentes. Para obter um exemplo de alteração dos modos de exibição em uma página que usa controles Web Parts, consulte Passo a passo: alterando modos de exibição em uma página Web Parts.

Como parte do gerenciamento do modo de exibição, o WebPartManager controle também fornece eventos e manipuladores de eventos relacionados a modos de exibição, como o OnDisplayModeChanged método e o OnDisplayModeChanging método. Esses métodos fornecem um mecanismo para personalizar o comportamento de uma página e até mesmo para adicionar um modo de exibição personalizado.

Aplica-se a