WebPartManager.DisplayMode Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví aktivní režim zobrazení webové stránky, která obsahuje webové části ovládací prvky.

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

Hodnota vlastnosti

WebPartDisplayMode

Určuje WebPartDisplayMode režim zobrazení stránky.

Atributy: BrowsableAttribute

Výjimky

ArgumentNullException

Objekt WebPartDisplayMode přiřazený k vlastnosti je null.

ArgumentException

Objekt WebPartDisplayMode přiřazený vlastnosti není jedním z podporovaných režimů zobrazení.

-nebo-

Objekt WebPartDisplayMode přiřazený k vlastnosti je zakázán.

Příklady

Následující příklad kódu ukazuje programové použití DisplayMode vlastnosti. Po načtení stránky v prohlížeči můžete pomocí tlačítek v dolní části stránky přepnout režimy zobrazení. Stránka je při načtení ve výchozím nastavení v režimu procházení. Pokud přepnete do režimu návrhu, můžete přetáhnout serverové ovládací prvky z jedné zóny do druhé nebo uspořádat dva ovládací prvky v jedné zóně. Pokud přepnete do režimu úprav, můžete kliknout na nabídku sloves v záhlaví některého ze serverových ovládacích prvků, vybrat Upravit a upravit ovládací prvek pomocí zadaného uživatelského rozhraní pro úpravy.

Poznámka

Přepínání mezi režimy zobrazení v aplikaci webových částí je velmi běžné a můžete chtít poskytnout konzistentní a opakovaně použitelný způsob, jak to provést na všech stránkách, které obsahují ovládací prvky webových částí. Příklad uživatelského ovládacího prvku, který mění režimy zobrazení a který lze opakovaně používat na mnoha stránkách, najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

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

Poznámky

Stránka, která obsahuje ovládací prvky webových částí, je vždy v jednom z několika možných režimů zobrazení. Podrobnosti o režimech zobrazení najdete v tématu Režimy zobrazení stránky webových částí.

Třída WebPartManager vytvoří režimy zobrazení pro webovou stránku. Pomocí základní WebPartDisplayMode třídy WebPartManager ovládací prvek vytvoří několik standardních objektů režimu zobrazení, které lze použít na stránkách, které obsahují ovládací prvky webových částí. Tyto standardní režimy zobrazení jsou popsány v přehledu WebPartDisplayMode třídy.

Ovládací WebPartManager prvek také spravuje režimy zobrazení pro stránky, které používají ovládací prvky webových částí. DisplayMode Pomocí vlastnosti WebPartManager zachová ovládací prvek odkaz na aktuální režim zobrazení na stránce. Vlastnost můžete také použít DisplayMode k přepnutí stránky do různých režimů zobrazení. Příklad změny režimů zobrazení na stránce, která používá ovládací prvky webových částí, najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

Jako součást správy režimu WebPartManager zobrazení ovládací prvek také poskytuje události a obslužné rutiny událostí vztahující se k režimům zobrazení, jako OnDisplayModeChanged je metoda a OnDisplayModeChanging metoda. Tyto metody poskytují mechanismus pro přizpůsobení chování stránky a dokonce i pro přidání vlastního režimu zobrazení.

Platí pro

Sdílet prostřednictvím