Gewusst wie: Festlegen des Anzeigemodus einer Webparts-Seite

Aktualisiert: November 2007

Die Webparts-Technologie bietet eine Vielzahl an Modi für die Seitenanzeige, mit deren Hilfe Benutzer Webseiten Ihren Vorstellungen entsprechend anpassen können. Der Entwickler einer Seite muss entscheiden, welche Anzeigemodi für den Endbenutzer erforderlich sind, und diese zur Verfügung stellen. In diesem Thema wird erläutert, wie Sie einfache Schaltflächen für Entwurf und Durchsuchen erstellen, mit denen die DisplayMode-Eigenschaft der WebPartManager-Instanz festgelegt wird. Im Entwurfsmodus können Benutzer Webparts-Steuerelemente per Drag & Drop verschieben, um das Layout der Seite anzupassen. Im Durchsuchen-Modus hingegen können Benutzer nur auf grundlegende Webbrowserfunktionen zugreifen. Beschreibungen der anderen Seitenanzeigemodi finden Sie unter Anzeigemodi für Webparts-Seiten.

So erstellen Sie die Schaltflächen Entwurf und Durchsuchen sowie deren Klickereignisse

1. Erstellen Sie eine ASP.NET-Seite, die ein WebPartManager-Steuerelement, verschiedene WebPartZone-Steuerelemente und verschiedene allgemeine Web-Steuerelemente innerhalb der Zonen enthält. Unter Exemplarische Vorgehensweise: Erstellen einer Webparts-Seite finden Sie Schritt-für-Schritt-Anleitungen.

2. Erstellen Sie zwei Button-Steuerelemente außerhalb der Zonen. Legen Sie für ein Steuerelement die ID-Eigenschaft und die Text-Eigenschaft jeweils auf Design fest. Legen Sie beide Eigenschaften des anderen Steuerelements auf Browse fest.

3. Fügen Sie die Click-Ereignishandler der beiden Schaltflächen einem <script>-Block am Anfang der Seite oder, wenn Sie eine Code-Behind-Datei verwenden, in der Codepage hinzu. Der Code sollte der Darstellung im folgenden Beispiel entsprechen:

   Protected Sub Design_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Design.Click
     ' Get the current WebPartManager instance.
     Dim mgr As WebPartManager
     mgr = WebPartManager.GetCurrentWebPartManager(Page)
   
     ' Set the display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes.Item("Design")
   End Sub
   
   Protected Sub Browse_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Browse.Click
     ' Get the current WebPartManager instance.
     Dim mgr As WebPartManager
     mgr = WebPartManager.GetCurrentWebPartManager(Page)
   
     ' Set the display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes.Item("Browse")
   End Sub
   

   protected void design_Click(object sender, EventArgs e)
   {
     // Get the current WebPartManager instance.
     WebPartManager mgr = WebPartManager.GetCurrentWebPartManager(Page);
   
     // Change the page display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes["Design"];
   }
   
   protected void browse_Click(object sender, EventArgs e)
   {
     // Get the current WebPartManager instance.
     WebPartManager mgr = WebPartManager.GetCurrentWebPartManager(Page);
   
     // Change it back.
     mgr.DisplayMode = mgr.SupportedDisplayModes["Browse"];
   }
   

4. Erstellen Sie die Seite, und führen Sie diese aus. Wenn Sie auf die Schaltfläche Entwurf klicken, sollten Sie die Steuerelemente zwischen den Zonen verschieben können. Wenn Sie auf die Schaltfläche Durchsuchen klicken, wird die Drag & Drop-Funktion deaktiviert.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Wechseln des Anzeigemodus auf einer Webparts-Seite

Konzepte

Anzeigemodi für Webparts-Seiten

Referenz

DisplayMode

WebPartManager