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 Anzeigemodi zu wechseln. Die Seite befindet sich standardmäßig im Browsemodus, wenn sie geladen wird. Wenn Sie zum Entwurfsmodus wechseln, können Sie die Serversteuerelemente von einer Zone in eine andere ziehen oder zwei Steuerelemente innerhalb einer Zone anordnen. Wenn Sie zum Bearbeitungsmodus wechseln, können Sie im Kopfzeile eines der Serversteuerelemente auf das Verbenmenü klicken, " Bearbeiten" auswählen und das Steuerelement mithilfe der bereitgestellten Benutzeroberfläche bearbeiten.

Hinweis

Das Wechseln zwischen Anzeigemodi in einer Webparts Anwendung ist sehr häufig, und Sie möchten möglicherweise eine konsistente, wiederverwendbare Möglichkeit bieten, dies auf allen 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 Webparts Seite.

<%@ 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 Webparts Steuerelemente enthält, befindet sich immer in einem von mehreren möglichen Anzeigemodi. Ausführliche Informationen zu Anzeigemodi finden Sie unter Webparts Seitenanzeigemodi.

Die WebPartManager Klasse erstellt die Anzeigemodi für eine Webseite. Mit 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 Webparts Steuerelemente verwenden. Mit 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 von Anzeigemodi auf einer Seite, die Webparts Steuerelemente verwendet, finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webparts Seite.

Im Rahmen der Verwaltung des Anzeigemodus stellt das WebPartManager Steuerelement auch Ereignisse und Ereignishandler für Anzeigemodi bereit, 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