WebPartManager.GetCurrentWebPartManager(Page) Methode

Definitie

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

Haalt een verwijzing naar het huidige exemplaar van het WebPartManager besturingselement op een pagina op.

public:
 static System::Web::UI::WebControls::WebParts::WebPartManager ^ GetCurrentWebPartManager(System::Web::UI::Page ^ page);
public static System.Web.UI.WebControls.WebParts.WebPartManager GetCurrentWebPartManager(System.Web.UI.Page page);
static member GetCurrentWebPartManager : System.Web.UI.Page -> System.Web.UI.WebControls.WebParts.WebPartManager
Public Shared Function GetCurrentWebPartManager (page As Page) As WebPartManager

Parameters

page
Page

De webpagina met een exemplaar van de WebPartManager.

Retouren

WebPartManager

Een WebPartManager die verwijst naar het huidige exemplaar van het besturingselement op een pagina.

Uitzonderingen

ArgumentNullException

page is null.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de GetCurrentWebPartManager methode gebruikt. Het voorbeeld heeft twee delen: een aangepast serverbeheer en een webpagina die als host fungeert voor het besturingselement.

Het aangepaste Label besturingselement gebruikt de GetCurrentWebPartManager methode om de id van het WebPartManager besturingselement op de huidige pagina op te halen en geeft vervolgens de id weer.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyManagerIDLabel : Label
  {

    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      this.Text = 
        WebPartManager.GetCurrentWebPartManager(Page).ID;
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyManagerIDLabel

    Inherits Label

    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)

      EnsureChildControls()
      Me.Text = _
        WebPartManager.GetCurrentWebPartManager(Page).ID

    End Sub

  End Class

End Namespace

Het volgende codevoorbeeld bevat de webpagina die als host fungeert voor het besturingselement in een WebPartZone zone.

<%@ Page Language="C#" %>
<%@ Register 
    Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="aspSample"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:MyManagerIDLabel ID="mgrID" runat="server" 
            Title="Manager ID Label" 
            Description="Displays the ID of the current WebPartManger."/>
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register 
    Namespace="Samples.AspNet.VB.Controls" 
    TagPrefix="aspSample"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:MyManagerIDLabel ID="mgrID" runat="server" 
            Title="Manager ID Label" 
            Description="Displays the ID of the current WebPartManger."/>
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    </form>
</body>
</html>

Nadat u de pagina in een browser hebt geladen, ziet u dat de id van het huidige WebPartManager besturingselement wordt weergegeven in het aangepaste Label besturingselement.

Opmerkingen

De GetCurrentWebPartManager methode is handig in contexten waarin u een verwijzing naar het huidige WebPartManager besturingselement wilt ophalen. Een veelvoorkomend scenario waarin dit zou gebeuren is als u een aangepast besturingselement schrijft dat niet weet tijdens de ontwikkeling wat de id van het besturingselement op de WebPartManager bijbehorende pagina is.

Note

De GetCurrentWebPartManager methode is statisch, zodat u deze rechtstreeks kunt aanroepen zonder dat u een exemplaar van een WebPartManager besturingselement nodig hebt.

Sommige besturingselementen in de besturingsset webonderdelen, zoals WebPart besturingselementen, hebben een WebPartManager eigenschap waarmee een verwijzing naar het huidige WebPartManager besturingselement kan worden opgehaald. Wanneer u met dergelijke besturingselementen werkt, moet u deze eigenschap daarom gebruiken om een verwijzing op te halen.

Als u code codeert in een context waarin u de id van het WebPartManager besturingselement kent, zoals het schrijven van code inline op een webpagina, is het eenvoudigst en meest efficiënt om rechtstreeks naar het besturingselement te verwijzen met behulp van de WebPartManager id.

Van toepassing op

Zie ook