Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Propriedade WebPartManager.SupportedDisplayModes

.NET Framework 3.5

Outras versões

Obtém uma coleção somente leitura de todos os modos de exibição que estão disponível em uma determinada página da Web.

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

Sintaxe

C++

JScript

[BrowsableAttribute(false)]
public WebPartDisplayModeCollection SupportedDisplayModes { get; }

Valor de propriedade

Tipo: System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection
A WebPartDisplayModeCollection que contém o conjunto de WebPartDisplayMode objetos disponível em uma página da Web específica.

Comentários

The SupportedDisplayModes propriedade contém apenas os modos de exibição que estão realmente disponível em uma página, considerando os tipos de zona controles presentes na página.

Observação:
Modos de exibição podem ser desativados e quando um modo de exibição é desabilitado, ele não será adicionado para a SupportedDisplayModes coleção, mesmo quando o modo de exibição do tipo correspondente de zona que oferece suporte a que está presente na página.

Sempre há suporte para o modo de procura e modo de design.Os modos de exibição que podem variar são a edição, catalogar e conectar-se modos.Cada um desses modos de exibição está associado um tipo específico de ToolZone controle. É a presença dessa zona especialmente digitada em uma página da Web que faz com que um modo de exibição específico a ser adicionado à coleção referenciada pelo SupportedDisplayModes propriedade. Por exemplo, se uma página da Web contém um EditorZone zona, mas não um CatalogZone zona, em seguida, o modo de exibição de edição é um dos modos suportados nessa página, mas não há suporte para o modo de exibição de catálogo.

Observação:
O SupportedDisplayModes propriedade difere do DisplayModes propriedade, que faz referência a uma coleção contendo todos os modos de exibição que estão disponível para o corrente WebPartManager controle, mesmo aqueles que não são suportadas em uma página específica.

Exemplos

O exemplo de código a seguir mostra o uso programático do SupportedDisplayModes propriedade. O código usa essa propriedade para popular a lista com apenas os modos de exibição disponível na página da Web corrente.

Existem três modos de exibição com suporte nesta página: Procurar, design e edição.Os dois primeiros estão sempre disponíveis e o modo de edição está disponível neste exemplo de código porque a página contém um EditorZone controle. O catálogo e conectar-se exibir modos não são mostrados, porque suas zonas correspondentes não estão nessa página.

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

  protectedvoid Page_Init(object sender, EventArgs e)
  {
    foreach (WebPartDisplayMode mode in mgr.SupportedDisplayModes)
    {
      string modeName = mode.Name;
      if (mode.IsEnabled(mgr))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }      
    }
  }

  protectedvoid DisplayModeDropdown_SelectedIndexChanged(object 
    sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;
    WebPartDisplayMode mode = 
      mgr.SupportedDisplayModes[selectedMode];
    if (mode != null)
      mgr.DisplayMode = mode;
  }

</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:DropDownList ID="DisplayModeDropdown" runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </div>
    </form>
</body>
</html>

Depois de carregar a página em um navegador, você pode usar o controle de lista suspensa para comutador a página do modo de procura para modo de design e, em seguida, o modo de edição.No modo de edição, você pode clicar na lista suspensa menu de verbos no cabeçalho de um dos controles de servidor e selecionar Editar para editar o controle.

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

Informações sobre versão