Compartilhar via


WebPartZoneBase.WebParts Propriedade

Definição

Obtém a coleção de controles de Web Parts contidos 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 da propriedade

Um WebPartCollection que contém referências a todos os controles de Web Parts em uma zona.

Atributos

Exemplos

O exemplo de código a seguir demonstra o uso programático da WebParts propriedade em um WebPartZone controle . Para obter o exemplo de código completo, incluindo o arquivo de origem code-behind e a página .aspx que contém a zona nesse código, consulte a visão geral da WebPartZoneBase classe.

O exemplo de código a seguir acessa a WebParts propriedade programaticamente e exibe uma lista dos controles contidos em WebPartZone1. Depois de carregar a página em um navegador, clique no botão rotulado Listar WebPartZone1 WebParts. As IDs e os tipos dos controles são exibidos.

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

Comentários

A WebParts propriedade pode conter referências a controles que herdam diretamente da WebPart classe , bem como outros controles de servidor ASP.NET ou controles personalizados dentro de uma zona. O conjunto de controle de Web Parts encapsula dinamicamente qualquer controle que não seja um WebPart controle como um GenericWebPart controle em tempo de execução; esse mecanismo permite que você use todos os tipos de controles de ASP.NET como controles de Web Parts.

Aplica-se a

Confira também