Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método WebPartManager.GetCurrentWebPartManager (Page)

 

Recupera uma referência à instância atual do controle de WebPartManager em uma página.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web.dll)

public static WebPartManager GetCurrentWebPartManager(
	Page page
)

Parâmetros

page

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

Valor de retorno

Type: System.Web.UI.WebControls.WebParts.WebPartManager

WebPartManager que referencia a instância atual do controle em uma página.

Exception Condition
ArgumentNullException

page é null.

O método de GetCurrentWebPartManager é útil em contextos em que você deseja recuperar uma referência ao controle de WebPartManager atual.Um cenário comum em que isto aconteça se você estiver escrevendo um controle personalizado que não pode saber durante o desenvolvimento o qual a ID de controle de WebPartManager na sua página será.

System_CAPS_noteObservação

O método de GetCurrentWebPartManager é estático, para que você possa chame diretamente sem precisar de uma instância de um controle de WebPartManager .

Alguns controles no conjunto de controle de Web Part, como WebPart controlam, têm uma propriedade de WebPartManager que possa recuperar uma referência ao controle de WebPartManager atual.Consequentemente, ao trabalhar com esses controles, você deve usar essa propriedade para recuperar uma referência.

Se você estiver codificando em um contexto em que você saiba o ID do controle de WebPartManager , como escrever código embutido dentro de uma página da Web, é mais simples e mais eficiente fazer referência diretamente o controle de WebPartManager usando a ID

O exemplo de código a seguir demonstra como usar o método de GetCurrentWebPartManager .O exemplo tem duas partes: um controle personalizado do servidor, e uma página da Web que hospeda o controle.

O controle de Label personalizadas usa o método de GetCurrentWebPartManager para recuperar a ID do controle de WebPartManager na página atual, e exibe a identificação

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;
    }

  }

}

O exemplo de código a seguir fornece a página da Web que hospeda o controle em uma área de WebPartZone .

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

Depois de carregar a página em um navegador, observe que a ID do controle atual de WebPartManager é exibido no controle personalizado de Label .

.NET Framework
Disponível desde 2.0
Retornar ao topo
Mostrar: