Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Propriedade WebPartManager.DisplayMode

 

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

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web.dll)

[BrowsableAttribute(false)]
public virtual WebPartDisplayMode DisplayMode { get; set; }

Valor da Propriedade

Type: System.Web.UI.WebControls.WebParts.WebPartDisplayMode

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

Exception Condition
ArgumentNullException

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

ArgumentException

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

- ou -

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

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

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

O WebPartManager controle também gerencia os modos de exibição para as páginas que usam controles Web Parts. Usando o DisplayMode propriedade, o WebPartManager controle mantém uma referência para o modo de exibição atual em uma página. Você também pode usar o DisplayMode propriedade para alternar uma página em diferentes modos de exibição. Para um exemplo de como alterar modos de exibição em uma página que usa controles de Web Parts, consulte Walkthrough: Changing Display Modes on a Web Parts Page.

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

O exemplo de código a seguir demonstra o uso programático do DisplayMode propriedade. Depois de carregar a página em um navegador, você pode usar os botões na parte inferior da página para alternar modos de exibição. A página está no modo de procura por padrão ao ser carregado. Se você alternar para modo de design, você pode arrastar os controles de servidor de uma zona para outro ou organizar dois controles dentro de uma zona. Se você alternar para o modo de edição, você pode clicar no cabeçalho de um dos controles de servidor, selecionados o menu de verbos Editar, e editar o controle usando a interface do usuário edição fornecido (UI).

System_CAPS_noteObservação

Alternar entre modos de exibição em um aplicativo de Web Parts é muito comum, e você talvez queira fornecer uma maneira consistente e reutilizável para fazer isso em todas as páginas que contêm controles de Web Parts. Para um exemplo de um controle de usuário que alterações exibem modos e que pode ser reutilizado em várias páginas, consulte 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>

.NET Framework
Disponível desde 2.0
Retornar ao início
Mostrar: