Sdílet prostřednictvím

WebPartManager.GetCurrentWebPartManager(Page) Metoda

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Načte odkaz na aktuální instanci WebPartManager ovládacího prvku na stránce.

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

Parametry

page
Page

Webová stránka, která obsahuje instanci WebPartManager.

Návraty

WebPartManager

A WebPartManager , který odkazuje na aktuální instanci ovládacího prvku na stránce.

Výjimky

ArgumentNullException

page je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetCurrentWebPartManager . Příklad má dvě části: vlastní serverový ovládací prvek a webovou stránku, která je hostitelem ovládacího prvku.

Vlastní Label ovládací prvek používá metodu GetCurrentWebPartManager k načtení ID WebPartManager ovládacího prvku na aktuální stránce a pak zobrazí ID.

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

Následující příklad kódu poskytuje webovou stránku, která je hostitelem WebPartZone ovládacího prvku v zóně.

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

Po načtení stránky v prohlížeči si všimněte, že ID aktuálního WebPartManager ovládacího prvku se zobrazí v rámci vlastního Label ovládacího prvku.

Poznámky

Metoda GetCurrentWebPartManager je užitečná v kontextech, kde chcete načíst odkaz na aktuální WebPartManager ovládací prvek. Běžným scénářem, kdy k tomu dojde, je, když píšete vlastní ovládací prvek, který během vývoje neví, jaké BUDE ID WebPartManager ovládacího prvku na jeho stránce.

Poznámka:

Metoda GetCurrentWebPartManager je statická, takže ji můžete volat přímo, aniž byste potřebovali instanci WebPartManager ovládacího prvku.

Některé ovládací prvky v sadě ovládacích částí webových částí, například WebPart ovládací prvky, mají WebPartManager vlastnost, která může načíst odkaz na aktuální WebPartManager ovládací prvek. Proto byste při práci s těmito ovládacími prvky měli tuto vlastnost použít k načtení odkazu.

Pokud kódujete v kontextu, kde znáte ID WebPartManager ovládacího prvku, například psaní kódu na webové stránce, je nejjednodušší a nejúčinnější odkazovat přímo na WebPartManager ovládací prvek pomocí jeho ID.

Platí pro

Viz také