Auf Englisch lesen

Teilen über

WebPartManager.BrowseDisplayMode Feld

  • Referenz

Definition

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

Stellt den Standardanzeigemodus für Seiten dar, die Webparts-Steuerelemente enthalten. Dieses Feld ist schreibgeschützt.

C# 
public static readonly System.Web.UI.WebControls.WebParts.WebPartDisplayMode BrowseDisplayMode;

Feldwert

WebPartDisplayMode

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie programmgesteuert mit dem BrowseDisplayMode Feld arbeiten. Der Code füllt eine Dropdownliste mit den unterstützten Anzeigemodi auf, die in diesem Fall durchsuchen und entwerfen sind. Beachten Sie, dass der Code in der Page_PreRender -Methode überprüft, ob die aktuelle DisplayMode Eigenschaft auf BrowseDisplayModefestgelegt ist. Wenn ja, Label1 wird angezeigt, und wenn nicht, Label1 wird ausgeblendet.

ASP.NET (C#) 
<%@ 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 mgr1.SupportedDisplayModes)
    {
      string modeName = mode.Name;
      if (mode.IsEnabled(mgr1))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }      
    }
  }

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

  protected void Page_PreRender(object sender, EventArgs e)
  {
    if (mgr1.DisplayMode == WebPartManager.BrowseDisplayMode)
      Label1.Visible = true;
    else
      Label1.Visible = false;
  }
</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="mgr1" 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>
      <hr />
      <asp:Label ID="Label1" runat="server" 
        Text="Currently in Browse Mode" 
        Font-Bold="true"
        Font-Size="125%" />
      <br />
      <asp:DropDownList ID="DisplayModeDropdown" runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </div>
    </form>
</body>
</html>

Nachdem Sie die Seite in einem Browser geladen haben, befinden Sie sich standardmäßig im Browsermodus. Beachten Sie die Bezeichnung auf der Seite, die angibt, dass Sie sich im Browsermodus befinden. Verwenden Sie das Dropdownlistensteuerelement, um die Seite in den Entwurfsmodus zu wechseln. Beachten Sie, dass die Bezeichnung aufgrund des Codes in der Page_PreRender -Methode jetzt ausgeblendet ist.

Hinweise

Das BrowseDisplayMode Feld verweist auf ein benutzerdefiniertes WebPartDisplayMode Objekt, das erstellt und im WebPartManager Steuerelement enthalten ist. Da es sich um ein statisches Objekt handelt, können Sie direkt über die WebPartManager -Klasse darauf verweisen, ohne dass eine Instanz des Steuerelements erforderlich ist.

Wenn eine Seite, die Webparts-Steuerelemente enthält, zum ersten Mal geladen wird, befindet sie sich standardmäßig im BrowseDisplayMode (Browsermodus). Wenn Benutzer einfach wie auf einer normalen Webseite surfen, verbleibt die Seite im Browsermodus. Wenn Benutzer das Layout, die Steuerelemente, das Aussehen oder das Verhalten einer Seite personalisieren möchten, müssen sie die Seite in einen der speziellen Anzeigemodi wechseln, die über die SupportedDisplayModes -Eigenschaft verfügbar sind.

Gilt für:

Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Weitere Informationen