WebPartManager.DisplayMode Propriedade

Definição

Espaço de Nomes:: System.Web.UI.WebControls.WebParts

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

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 Propriedade

WebPartDisplayMode

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

Atributos: BrowsableAttribute

Exceções

ArgumentNullException

O WebPartDisplayMode objeto atribuído à propriedade é null.

ArgumentException

O WebPartDisplayMode objeto atribuído à propriedade não é um dos modos de exibição suportados.

-ou-

O WebPartDisplayMode objeto atribuído à propriedade está desativado.

Exemplos

O exemplo de código seguinte demonstra o uso programático da DisplayMode propriedade. Depois de carregar a página num navegador, pode usar os botões perto do fundo da página para mudar de modo de visualização. A página está em modo de navegação por defeito quando carrega. Se mudares para o modo de design, podes arrastar os controlos do servidor de uma zona para outra, ou organizar dois controlos dentro de uma zona. Se mudares para o modo de edição, podes clicar no menu de verbos no cabeçalho de qualquer um dos controlos do servidor, selecionar Editar e editar o controlo usando a interface de utilizador de edição (UI) fornecida.

Note

Alternar entre modos de visualização numa aplicação de Web Parts é muito comum, e pode querer fornecer uma forma consistente e reutilizável de o fazer em todas as suas páginas que contenham controlos de Web Parts. Para um exemplo de controlo do utilizador que altera modos de visualização e que pode ser reutilizado em muitas páginas, veja 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>

Observações

Uma página que contém controlos de Web Parts está sempre num dos vários modos de visualização possíveis. Para detalhes sobre modos de visualização, consulte Modos de Exibição da Página de Componentes Web.

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

O WebPartManager controlo também gere os modos de visualização para páginas que utilizam controlos de Web Parts. Usando esta DisplayMode propriedade, o controlo WebPartManager mantém uma referência ao modo de exibição atual numa página. Também pode usar a DisplayMode propriedade para mudar uma página para diferentes modos de visualização. Para um exemplo de mudança de modos de visualização numa página que utiliza controlos de Web Parts, veja Walkthrough: Changing Display Modes on a Web Parts Page.

Como parte da gestão do modo de visualização, o controlo WebPartManager também fornece eventos e gestores de eventos relacionados com os modos de visualização, como o OnDisplayModeChanged método e o OnDisplayModeChanging método. Estes métodos fornecem um mecanismo para personalizar o comportamento de uma página e até para adicionar um modo de exibição personalizado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?