Sdílet prostřednictvím

WebPartManager.GetCurrentWebPartManager(Page) Metoda

  • Reference

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 objektu 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, že píšete vlastní ovládací prvek, který během vývoje nemůže vědět, 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 bez nutnosti instance WebPartManager ovládacího prvku.

Některé ovládací prvky v sadě ovládacích prvků 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 použít tuto vlastnost k načtení odkazu.

Pokud kódujete v kontextu, ve kterém znáte ID WebPartManager ovládacího prvku, například psaní kódu vloženého 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é