WebPartManager.GetCurrentWebPartManager(Page) Método

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recupera uma referência à instância atual do WebPartManager controlo numa página.

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

Parâmetros

page
Page

A página Web que contém uma instância do WebPartManager.

Devoluções

WebPartManager

A WebPartManager que faz referência à instância atual do controlo numa página.

Exceções

ArgumentNullException

page é null.

Exemplos

O exemplo de código seguinte demonstra como usar o GetCurrentWebPartManager método. O exemplo tem duas partes: um controlo de servidor personalizado e uma página Web que hospeda o controlo.

O controlo personalizado Label utiliza o GetCurrentWebPartManager método para recuperar o ID do WebPartManager controlo na página atual e depois exibe o 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

O exemplo de código seguinte fornece a página Web que aloja o controlo numa WebPartZone zona.

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

Depois de carregar a página num navegador, repare que o ID do controlo atual WebPartManager é exibido dentro do controlo personalizado Label .

Observações

O GetCurrentWebPartManager método é útil em contextos onde se pretende recuperar uma referência ao controlo atual WebPartManager . Um cenário comum onde isto aconteceria é se estiver a escrever um controlo personalizado que não pode saber, durante o desenvolvimento, qual será o ID do WebPartManager controlo na sua página.

Note

O GetCurrentWebPartManager método é estático, por isso podes chamá-lo diretamente sem precisar de uma instância de controlo WebPartManager .

Alguns controlos no conjunto de controlos Web Parts, como WebPart os controlos, têm uma WebPartManager propriedade que pode recuperar uma referência ao controlo atual WebPartManager . Por isso, ao trabalhar com tais controlos, deve usar esta propriedade para obter uma referência.

Se estiver a programar num contexto onde conhece o ID do WebPartManager controlo, como escrever código em linha dentro de uma página Web, é mais simples e eficiente referir-se diretamente ao WebPartManager controlo usando o seu ID.

Aplica-se a

Ver também