WebPartManager.SupportedDisplayModes Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera kolekcję tylko do odczytu wszystkich trybów wyświetlania, które są dostępne na określonej stronie sieci Web.

public:
 property System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ SupportedDisplayModes { System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection SupportedDisplayModes { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SupportedDisplayModes : System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection

Public ReadOnly Property SupportedDisplayModes As WebPartDisplayModeCollection

Wartość właściwości

WebPartDisplayModeCollection

Element WebPartDisplayModeCollection zawierający zestaw WebPartDisplayMode obiektów dostępnych na określonej stronie sieci Web.

Atrybuty: BrowsableAttribute

Przykłady

Poniższy przykład kodu przedstawia programowe użycie SupportedDisplayModes właściwości. Kod używa tej właściwości do wypełnienia listy tylko trybami wyświetlania dostępnymi na bieżącej stronie sieci Web.

Na tej stronie są dostępne trzy obsługiwane tryby wyświetlania: przeglądanie, projektowanie i edytowanie. Pierwsze dwa są zawsze dostępne, a tryb edycji jest dostępny w tym przykładzie kodu, ponieważ strona zawiera kontrolkę EditorZone . Tryby wyświetlania wykazu i łączenia nie są wyświetlane, ponieważ ich odpowiednie strefy nie znajdują się na tej stronie.

<%@ 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 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);
      }      
    }
  }

  protected void 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>

<%@ 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 Page_Init(ByVal sender As Object, _
    ByVal e As EventArgs)
    Dim mode As WebPartDisplayMode
    For Each mode In mgr.SupportedDisplayModes
      Dim modeName As String = mode.Name
      If mode.IsEnabled(mgr) Then
        Dim item As ListItem = New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next
    
  End Sub

  Protected Sub DisplayModeDropdown_SelectedIndexChanged(ByVal _
    sender As Object, ByVal e As EventArgs)
    Dim selectedMode As String = _
      DisplayModeDropdown.SelectedValue
    Dim mode As WebPartDisplayMode = _
      mgr.SupportedDisplayModes(selectedMode)
    If mode IsNot Nothing Then
      mgr.DisplayMode = mode
    End If
  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:DropDownList ID="DisplayModeDropdown" runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </div>
    </form>
</body>
</html>

Po załadowaniu strony w przeglądarce możesz użyć kontrolki listy rozwijanej, aby przełączyć stronę z trybu przeglądania na tryb projektowania, a następnie edytować tryb. W trybie edycji możesz kliknąć menu zleceń rozwijanych w nagłówku jednej z kontrolek serwera, a następnie wybrać pozycję Edytuj , aby edytować kontrolkę.

Uwagi

Właściwość SupportedDisplayModes zawiera tylko tryby wyświetlania, które są rzeczywiście dostępne na stronie, biorąc pod uwagę rodzaje kontrolek stref znajdujących się na stronie.

Uwaga

Tryby wyświetlania można wyłączyć, a gdy tryb wyświetlania jest wyłączony, nie jest dodawany do SupportedDisplayModes kolekcji, nawet jeśli odpowiedni typ strefy obsługującej ten tryb wyświetlania jest obecny na stronie.

Tryb przeglądania i tryb projektowania są zawsze obsługiwane. Tryby wyświetlania, które mogą się różnić, to tryby edycji, katalogu i łączenia. Każdy z tych trybów wyświetlania jest skojarzony z określonym typem kontrolki ToolZone . Jest to obecność tej specjalnie typizowanej strefy na stronie sieci Web, która powoduje dodanie określonego trybu wyświetlania do kolekcji przywoływanych przez SupportedDisplayModes właściwość. Jeśli na przykład strona sieci Web zawiera strefę EditorZone , ale nie strefę CatalogZone , tryb wyświetlania edycji jest jednym z obsługiwanych trybów na tej stronie, ale tryb wyświetlania wykazu nie jest obsługiwany.

Uwaga

Właściwość SupportedDisplayModes różni się od DisplayModes właściwości, która odwołuje się do kolekcji zawierającej wszystkie tryby wyświetlania dostępne dla bieżącej WebPartManager kontrolki, nawet te, które nie są obsługiwane na określonej stronie.

Dotyczy

Share via