WebPartZoneBase.WebParts Propriedade

Definição

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

Obtém a coleção de controlos de Web Parts contida dentro de uma zona.

public:
 property System::Web::UI::WebControls::WebParts::WebPartCollection ^ WebParts { System::Web::UI::WebControls::WebParts::WebPartCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartCollection WebParts { get; }
[<System.ComponentModel.Browsable(false)>]
member this.WebParts : System.Web.UI.WebControls.WebParts.WebPartCollection
Public ReadOnly Property WebParts As WebPartCollection

Valor de Propriedade

WebPartCollection

A WebPartCollection que contém referências a todos os controlos Web Parts numa zona.

Atributos
BrowsableAttribute

Exemplos

O seguinte exemplo de código demonstra a utilização programática da WebParts propriedade num WebPartZone controlo. Para o exemplo completo do código, incluindo o ficheiro-fonte code-behind e a página .aspx que contém a zona neste código, veja a visão geral da WebPartZoneBase classe.

O seguinte exemplo de código acede programaticamente à WebParts propriedade e apresenta uma lista dos controlos contidos em WebPartZone1. Depois de carregar a página num navegador, clique no botão intitulado Listar WebPartZone1 WebParts. Os IDs e tipos dos controlos são mostrados.

protected void Button3_Click(object sender, EventArgs e)
{
  StringBuilder builder = new StringBuilder();
  builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
  foreach (WebPart part in WebPartZone1.WebParts)
  {
    builder.AppendLine("ID: " + part.ID 
                        + "; Type:  " + part.GetType() 
                        + @"<br />");
  }
  Label2.Text = builder.ToString();
  Label2.Visible = true;
}

Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs) 
  Dim builder As New StringBuilder()
  builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
  Dim part As WebPart
  For Each part In  WebPartZone1.WebParts
    builder.AppendLine("ID: " + part.ID + "; Type: " _
                        + part.GetType().ToString() _
                        + "<br />")
  Next part
  Label2.Text = builder.ToString()
  Label2.Visible = True
End Sub

Observações

A propriedade WebParts pode conter referências a controlos que herdam diretamente da classe WebPart, bem como a outros controlos ASP.NET servidores ou controlos personalizados dentro de uma zona. O conjunto de controlo Web Parts envolve dinamicamente qualquer controlo que não seja um controlo WebPart como controlo GenericWebPart em tempo de execução; este mecanismo permite-lhe usar todos os tipos de controlos ASP.NET como controlos Web Parts.

Aplica-se a

Ver também