WebPartManager.DisplayMode Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia aktywny tryb wyświetlania dla strony sieci Web zawierającej kontrolki składników Web Part.

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

Wartość właściwości

WebPartDisplayMode

Element WebPartDisplayMode określający tryb wyświetlania strony.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentNullException

WebPartDisplayMode Obiekt przypisany do właściwości to null.

ArgumentException

WebPartDisplayMode Obiekt przypisany do właściwości nie jest jednym z obsługiwanych trybów wyświetlania.

-lub-

WebPartDisplayMode Obiekt przypisany do właściwości jest wyłączony.

Przykłady

Poniższy przykład kodu pokazuje programowe użycie DisplayMode właściwości. Po załadowaniu strony w przeglądarce można użyć przycisków w dolnej części strony, aby przełączyć tryby wyświetlania. Strona jest domyślnie w trybie przeglądania podczas ładowania. Jeśli przełączysz się do trybu projektowania, możesz przeciągnąć kontrolki serwera z jednej strefy do innej lub rozmieścić dwie kontrolki w jednej strefie. Jeśli przełączysz się do trybu edycji, możesz kliknąć menu czasowników w nagłówku jednej z kontrolek serwera, wybrać pozycję Edytuj i edytować kontrolkę przy użyciu udostępnionego interfejsu użytkownika edycji.

Uwaga

Przełączanie między trybami wyświetlania w aplikacji składników Web Part jest bardzo powszechne i warto zapewnić spójny, wielokrotnego użytku sposób wykonywania tych czynności na wszystkich stronach zawierających kontrolki składników Web Part. Aby zapoznać się z przykładem kontrolki użytkownika, która zmienia tryby wyświetlania i które mogą być ponownie używane na wielu stronach, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składników Web Part.

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

Uwagi

Strona zawierająca kontrolki składników Web Part jest zawsze w jednym z kilku możliwych trybów wyświetlania. Aby uzyskać szczegółowe informacje na temat trybów wyświetlania, zobacz Tryby wyświetlania stron składników Web Part.

Klasa WebPartManager tworzy tryby wyświetlania dla strony sieci Web. Za pomocą klasy bazowej WebPartDisplayMode kontrolka WebPartManager tworzy kilka standardowych obiektów trybu wyświetlania, które mogą być używane na stronach zawierających kontrolki składników Web Part. Te standardowe tryby wyświetlania są opisane w przeglądzie WebPartDisplayMode klasy.

Kontrolka WebPartManager zarządza również trybami wyświetlania stron korzystających z kontrolek składników Web Part. Za pomocą właściwości kontrolka DisplayMode WebPartManager przechowuje odwołanie do bieżącego trybu wyświetlania na stronie. Można również użyć DisplayMode właściwości , aby przełączyć stronę do różnych trybów wyświetlania. Aby zapoznać się z przykładem zmiany trybów wyświetlania na stronie korzystającej z kontrolek składników Web Part, zobacz Przewodnik: zmienianie trybów wyświetlania na stronie składników Web Part.

W ramach zarządzania trybem wyświetlania kontrolka WebPartManager udostępnia również zdarzenia i programy obsługi zdarzeń związane z trybami wyświetlania, takimi jak OnDisplayModeChanged metoda i OnDisplayModeChanging metoda. Te metody zapewniają mechanizm dostosowywania zachowania strony, a nawet do dodawania niestandardowego trybu wyświetlania.

Dotyczy

Udostępnij za pośrednictwem