Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Método WebPartManager.GetGenericWebPart

.NET Framework 4.5

Outras versões

Obtém uma referência à instância da GenericWebPart o controle que contém um controle de servidor.

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

Sintaxe

C++

public GenericWebPart GetGenericWebPart(
	Control control
)

Parâmetros

control: Tipo: System.Web.UI.Control
Um controle de servidor que existe em um WebPartZoneBase e é empacotado como um controle filho de um GenericWebPart em tempo de execução.

Valor de retorno

Tipo: System.Web.UI.WebControls.WebParts.GenericWebPart
A GenericWebPart que continua control como um controle filho. O método retorna null se control não está contida em um GenericWebPart.

Exceções

Exceção	Condição
ArgumentNullException	control é null.

Comentários

Em geral, há duas categorias de controles que os desenvolvedores colocam em WebPartZoneBase zonas para participar de aplicativos de Web Parts: WebPart controles que herdam a WebPart classe base e outros controles de servidor, que podem ser o padrão do ASP.NET personalizados, controles personalizados ou controles de usuário. Quando qualquer desses controles é colocado em um WebPartZoneBase zona, ele assume a funcionalidade de um WebPart controle. A WebPart controle tem essa funcionalidade por natureza, mas outros tipos de controles de servidor não. Para permitir que os outros controles de servidor atuar como WebPart controla quando eles são colocados em um WebPartZoneBase de zona, ASP.NET envolve-os com um GenericWebPart controle. Porque o GenericWebPart controle herda diretamente a WebPart classe, ele fornece seus controles filho com recursos de Web Parts de true.

Muitas vezes, no tempo de execução, os desenvolvedores de páginas talvez queira obter uma referência para o GenericWebPart controle que contém um dos controles de servidor em uma zona. O GetGenericWebPart método habilita a recuperar uma referência a GenericWebPart controle.

Exemplos

O exemplo de código a seguir demonstra o uso da GetGenericWebPart método. O exemplo de código contém um Calendar controle declarada dentro de um WebPartZone zona. O Button1_Click método imprime primeiro a identificação da Calendar controle para um rótulo e, em seguida, usa o GetGenericWebPart método para recuperar uma referência para o GenericWebPart controle que encapsula o calendário. A identificação da GenericWebPart controle e a identificação do controle filho (que é o Calendar controle), são impressos para um segundo label.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h2>Server Control</h2>";
    Label1.Text += "Server Control ID:  " + Calendar1.ID;
    Label2.Text = "<h2>GenericWebPart Control</h2>";
    GenericWebPart part = mgr.GetGenericWebPart(Calendar1);
    if (part != null)
    {
      Label2.Text +=
        "GenericWebPart ID:  " + part.ID + "<br />";
      Label2.Text +=
        "Underlying Control ID: " + part.ChildControl.ID;
    }
  }

</script>

<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="mgr" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Get GenericWebPart"
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" Text="" />
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
    </div>
    </form>
</body>
</html>

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também

Referência

WebPartManager Classe

Namespace System.Web.UI.WebControls.WebParts

GenericWebPart

Outros recursos

ASP.NET Web Parts Pages

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR