Freigeben über

WebPartManager.DisplayModes Eigenschaft

Definition

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

Ruft eine schreibgeschützte Auflistung aller Anzeigemodi ab, die einem WebPartManager Steuerelement zugeordnet sind.

public:
 property System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ DisplayModes { System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection DisplayModes { get; }
[<System.ComponentModel.Browsable(false)>]
member this.DisplayModes : System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection
Public ReadOnly Property DisplayModes As WebPartDisplayModeCollection

Eigenschaftswert

WebPartDisplayModeCollection

A WebPartDisplayModeCollection that contains the set of WebPartDisplayMode objects associated with the WebPartManager control.

Attribute
BrowsableAttribute

Beispiele

Das folgende Codebeispiel zeigt die programmgesteuerte Verwendung der DisplayModes Eigenschaft. Der Code verwendet diese Eigenschaft, um die Liste mit allen anzeigemodi aufzufüllen, die im Webpart-Steuerelementsatz verfügbar sind, auch diejenigen, die auf der aktuellen Seite nicht unterstützt werden. In diesem Fall werden die Anzeigemodi für Kataloge und Verbindungen nicht unterstützt, da sich die entsprechenden erforderlichen Zonen nicht auf der Seite befinden.

Die anderen drei Anzeigemodi – Durchsuchen, Entwerfen und Bearbeiten – werden auf der Seite unterstützt. Der Bearbeitungsmodus wird unterstützt, da die Seite eine EditorZone Zone enthält, während die Such- und Entwurfsmodi immer unterstützt werden.

Nachdem Sie die Seite in einem Browser geladen haben, können Sie das Dropdownlistensteuerelement verwenden, um die Seite vom Navigationsmodus in den Entwurfsmodus zu wechseln und dann zum Bearbeitungsmodus zu wechseln. Im Bearbeitungsmodus können Sie auf das Dropdown-Verben-Menü in der Kopfzeile eines der Serversteuerelemente klicken und "Bearbeiten" auswählen, um das Steuerelement zu bearbeiten. Beachten Sie, dass beim Auswählen von Katalog oder Verbinden in der Dropdownliste eine Fehlerseite generiert wird.

<%@ 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.DisplayModes)
    {
      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.DisplayModes[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.DisplayModes
      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.DisplayModes(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>

Hinweise

Die DisplayModes Eigenschaft verweist auf alle zugeordneten Anzeigemodi, im Gegensatz zur SupportedDisplayModes Eigenschaft, die nur auf die Anzeigemodi verweist, die auf der aktuellen Seite verfügbar (unterstützt) sind.

Zwei der bereitgestellten Anzeigemodi, Durchsuchen und Entwerfen, werden immer auf einer Seite unterstützt. Die anderen drei Anzeigemodi, Bearbeitungsmodi, Kataloge und Verbindungen werden nur unterstützt, wenn eine Seite den entsprechenden Zonentyp aufweist, der für einen bestimmten Anzeigemodus erforderlich ist. Wenn Sie beispielsweise keine Zone enthalten EditorZone , wird der Bearbeitungsanzeigemodus in der Auflistung angezeigt, auf die von der DisplayModes Eigenschaft verwiesen wird, aber nicht in der Auflistung angezeigt, auf die von der SupportedDisplayModes Eigenschaft verwiesen wird.

Gilt für:

Weitere Informationen