WebPartManager.DisplayMode Eigenschap

Definitie

Naamruimte:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee haalt u de actieve weergavemodus op of stelt u deze in voor een webpagina met besturingselementen voor webonderdelen.

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

Waarde van eigenschap

WebPartDisplayMode

Een WebPartDisplayMode die de weergavemodus van een pagina bepaalt.

Kenmerken: BrowsableAttribute

Uitzonderingen

ArgumentNullException

Het WebPartDisplayMode object dat wordt toegewezen aan de eigenschap is null.

ArgumentException

Het WebPartDisplayMode object dat aan de eigenschap wordt toegewezen, is geen van de ondersteunde weergavemodi.

– of –

Het WebPartDisplayMode object dat aan de eigenschap wordt toegewezen, is uitgeschakeld.

Voorbeelden

In het volgende codevoorbeeld ziet u een programmatisch gebruik van de DisplayMode eigenschap. Nadat u de pagina in een browser hebt geladen, kunt u de knoppen onderaan de pagina gebruiken om de weergavemodi te wijzigen. De pagina bevindt zich standaard in de bladermodus wanneer deze wordt geladen. Als u overschakelt naar de ontwerpmodus, kunt u de serverbesturingselementen van de ene zone naar de andere slepen of twee besturingselementen in één zone rangschikken. Als u overschakelt naar de bewerkingsmodus, kunt u klikken op het menu Werkwoorden in de koptekst van een van de serverbesturingselementen, bewerken en het besturingselement bewerken met behulp van de meegeleverde gebruikersinterface (UI).

Note

Schakelen tussen weergavemodi in een webonderdelentoepassing is heel gebruikelijk en u wilt mogelijk een consistente, herbruikbare manier bieden om dit te doen op al uw pagina's met besturingselementen voor webonderdelen. Zie Overzicht: Weergavemodi op een pagina met webonderdelen wijzigen voor een voorbeeld van een gebruikersbeheer waarmee weergavemodi worden gewijzigd en die opnieuw kunnen worden gebruikt op veel pagina's.

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

Opmerkingen

Een pagina met besturingselementen voor webonderdelen bevindt zich altijd in een van de verschillende mogelijke weergavemodi. Zie Weergavemodi voor webonderdelenpagina's voor meer informatie over weergavemodi.

De WebPartManager klasse maakt de weergavemodi voor een webpagina. Met behulp van de basisklasse WebPartDisplayMode maakt het WebPartManager besturingselement verschillende standaardweergavemodusobjecten die kunnen worden gebruikt op pagina's die besturingselementen voor webonderdelen bevatten. Deze standaardweergavemodi worden beschreven in het WebPartDisplayMode klassenoverzicht.

Het WebPartManager besturingselement beheert ook de weergavemodi voor pagina's die gebruikmaken van besturingselementen voor webonderdelen. Met behulp van de DisplayMode eigenschap houdt het WebPartManager besturingselement een verwijzing naar de huidige weergavemodus op een pagina. U kunt de DisplayMode eigenschap ook gebruiken om een pagina over te schakelen naar verschillende weergavemodi. Zie Overzicht: Weergavemodi wijzigen op een pagina waarop besturingselementen voor webonderdelen worden gebruikt, voor een voorbeeld van het wijzigen van weergavemodi op een pagina met webonderdelen.

Als onderdeel van het beheren van de weergavemodus biedt het WebPartManager besturingselement ook gebeurtenissen en gebeurtenis-handlers met betrekking tot weergavemodi, zoals de OnDisplayModeChanged methode en de OnDisplayModeChanging methode. Deze methoden bieden een mechanisme voor het aanpassen van het gedrag van een pagina en zelfs voor het toevoegen van een aangepaste weergavemodus.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?