WebPartManager.DisplayMode Egenskap

Definition

Namnområde:: System.Web.UI.WebControls.WebParts

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar eller anger aktivt visningsläge för en webbsida som innehåller webbdelskontroller.

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

Egenskapsvärde

WebPartDisplayMode

En WebPartDisplayMode som avgör en sidas visningsläge.

Attribut: BrowsableAttribute

Undantag

ArgumentNullException

Objektet WebPartDisplayMode som tilldelas egenskapen är null.

ArgumentException

Objektet WebPartDisplayMode som tilldelas egenskapen är inte ett av de visningslägen som stöds.

-eller-

Objektet WebPartDisplayMode som tilldelas egenskapen är inaktiverat.

Exempel

I följande kodexempel visas programmatisk användning av DisplayMode egenskapen. När du har läst in sidan i en webbläsare kan du använda knapparna längst ned på sidan för att växla visningslägen. Sidan är i bläddra-läge som standard när den läses in. Om du växlar till designläge kan du dra serverkontrollerna från en zon till en annan eller ordna två kontroller inom en zon. Om du växlar till redigeringsläge kan du klicka på verbmenyn i rubriken för någon av serverkontrollerna, välja Redigera och redigera kontrollen med hjälp av det angivna användargränssnittet (UI).

Note

Det är mycket vanligt att växla mellan visningslägen i ett webbdelsprogram, och du kanske vill tillhandahålla ett konsekvent och återanvändbart sätt att göra detta på alla sidor som innehåller webbdelskontroller. Ett exempel på en användarkontroll som ändrar visningslägen och som kan återanvändas på många sidor finns i Genomgång: Ändra visningslägen på en webbdelssida.

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

Kommentarer

En sida som innehåller kontroller för webbdelar finns alltid i något av flera möjliga visningslägen. Mer information om visningslägen finns i Visningslägen för webbdelar.

Klassen WebPartManager skapar visningslägena för en webbsida. Med hjälp av basklassen WebPartDisplayMode WebPartManager skapar kontrollen flera standardobjekt i visningsläge som kan användas på sidor som innehåller webbdelskontroller. Dessa standardvisningslägen beskrivs i klassöversikten WebPartDisplayMode .

Kontrollen WebPartManager hanterar också visningslägena för sidor som använder webbdelskontroller. Med hjälp av DisplayMode egenskapen WebPartManager behåller kontrollen en referens till det aktuella visningsläget på en sida. Du kan också använda egenskapen DisplayMode för att växla en sida till olika visningslägen. Ett exempel på hur du ändrar visningslägen på en sida som använder webbdelskontroller finns i Genomgång: Ändra visningslägen på en webbsida.

Som en del av hanteringen av visningsläget WebPartManager tillhandahåller kontrollen även händelser och händelsehanterare som rör visningslägen, till exempel OnDisplayModeChanged metoden och OnDisplayModeChanging metoden. De här metoderna ger en mekanism för att anpassa en sidas beteende och även för att lägga till ett anpassat visningsläge.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?