WebPartManager.GetCurrentWebPartManager(Page) Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar en referens till den aktuella instansen WebPartManager av kontrollen på en sida.

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

Parametrar

page
Page

Webbsidan som innehåller en instans av WebPartManager.

Returer

WebPartManager

En WebPartManager som refererar till den aktuella instansen av kontrollen på en sida.

Undantag

ArgumentNullException

page är null.

Exempel

I följande kodexempel visas hur du använder GetCurrentWebPartManager metoden. Exemplet har två delar: en anpassad serverkontroll och en webbsida som är värd för kontrollen.

Den anpassade Label kontrollen använder GetCurrentWebPartManager metoden för att hämta kontrollens WebPartManager ID på den aktuella sidan och visar sedan ID:t.

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

Följande kodexempel innehåller den webbsida som är värd för kontrollen i en WebPartZone zon.

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

När du har läst in sidan i en webbläsare ser du att ID:t för den aktuella WebPartManager kontrollen visas i den anpassade Label kontrollen.

Kommentarer

Metoden GetCurrentWebPartManager är användbar i kontexter där du vill hämta en referens till den aktuella WebPartManager kontrollen. Ett vanligt scenario där detta skulle inträffa är om du skriver en anpassad kontroll som inte kan veta under utvecklingen vad ID:t för WebPartManager kontrollen på dess sida kommer att vara.

Note

Metoden GetCurrentWebPartManager är statisk, så du kan anropa den direkt utan att behöva en instans av en WebPartManager kontroll.

Vissa kontroller i kontrolluppsättningen webbdelar, till exempel WebPart kontroller, har en WebPartManager egenskap som kan hämta en referens till den aktuella WebPartManager kontrollen. När du arbetar med sådana kontroller bör du därför använda den här egenskapen för att hämta en referens.

Om du kodar i en kontext där du känner till kontrollens ID WebPartManager , till exempel att skriva kod infogad på en webbsida, är det enklast och mest effektivt att referera direkt till WebPartManager kontrollen med hjälp av dess ID.

Gäller för

Se även