WebPartManager.DisplayMode Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den aktiven Anzeigemodus für eine Webseite ab, die Webparts-Steuerelemente enthält, oder legt diesen fest.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ DisplayMode { System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ get(); void set(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartDisplayMode DisplayMode { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayMode with get, set

Public Overridable Property DisplayMode As WebPartDisplayMode

Eigenschaftswert

WebPartDisplayMode

Ein WebPartDisplayMode, der den Anzeigemodus einer Seite bestimmt.

Attribute: BrowsableAttribute

Ausnahmen

ArgumentNullException

Das WebPartDisplayMode-Objekt, das der Eigenschaft zugewiesen wird, lautet null.

ArgumentException

Das WebPartDisplayMode-Objekt, das der Eigenschaft zugewiesen wird, entspricht keinem der unterstützten Anzeigemodi.

- oder -

Das WebPartDisplayMode-Objekt, das der Eigenschaft zugewiesen wird, ist deaktiviert.

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der DisplayMode -Eigenschaft veranschaulicht. Nach dem Laden der Seite in einem Browser können Sie die Schaltflächen am unteren Rand der Seite verwenden, um die Anzeigemodi zu wechseln. Die Seite befindet sich beim Laden standardmäßig im Durchsuchmodus. Wenn Sie in den Entwurfsmodus wechseln, können Sie die Serversteuerelemente von einer Zone in eine andere ziehen oder zwei Steuerelemente innerhalb einer Zone anordnen. Wenn Sie in den Bearbeitungsmodus wechseln, können Sie in der Kopfzeile eines der Serversteuerelemente auf das Verbenmenü klicken, Bearbeiten auswählen und das Steuerelement mithilfe der bereitgestellten Benutzeroberfläche (UI) bearbeiten.

Hinweis

Das Wechseln zwischen Anzeigemodi in einer Webpartanwendung ist sehr häufig, und Sie können eine konsistente, wiederverwendbare Möglichkeit bieten, dies auf all Ihren Seiten zu tun, die Webparts-Steuerelemente enthalten. Ein Beispiel für ein Benutzersteuerelement, das anzeigemodi ändert und auf vielen Seiten wiederverwendet werden kann, finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.

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

<%@ 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 Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.DesignDisplayMode
  End Sub
  
  Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.EditDisplayMode
  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: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>

Hinweise

Eine Seite, die Webpart-Steuerelemente enthält, befindet sich immer in einem von mehreren möglichen Anzeigemodi. Ausführliche Informationen zu Anzeigemodi finden Sie unter Anzeigemodi der Webparts-Seite.

Die WebPartManager -Klasse erstellt die Anzeigemodi für eine Webseite. Mithilfe der Basisklasse WebPartDisplayMode erstellt das WebPartManager Steuerelement mehrere Standardanzeigemodusobjekte, die auf Seiten verwendet werden können, die Webparts-Steuerelemente enthalten. Diese Standardanzeigemodi werden in der WebPartDisplayMode Klassenübersicht beschrieben.

Das WebPartManager Steuerelement verwaltet auch die Anzeigemodi für Seiten, die Webpart-Steuerelemente verwenden. Mithilfe der DisplayMode -Eigenschaft behält das WebPartManager Steuerelement einen Verweis auf den aktuellen Anzeigemodus auf einer Seite bei. Sie können die DisplayMode -Eigenschaft auch verwenden, um eine Seite in verschiedene Anzeigemodi zu wechseln. Ein Beispiel für das Ändern der Anzeigemodi auf einer Seite, die Webpart-Steuerelemente verwendet, finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.

Im Rahmen der Verwaltung des Anzeigemodus stellt das WebPartManager Steuerelement auch Ereignisse und Ereignishandler bereit, die sich auf Anzeigemodi beziehen, z. B. die OnDisplayModeChanged -Methode und die OnDisplayModeChanging -Methode. Diese Methoden bieten einen Mechanismus zum Anpassen des Verhaltens einer Seite und sogar zum Hinzufügen eines benutzerdefinierten Anzeigemodus.

Gilt für:

Freigeben über