WebPartZoneBase.WebParts Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient la collection de contrôles WebPart contenus dans une zone.

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

Valeur de propriété

WebPartCollection

WebPartCollection qui contient les références à tous les contrôles WebPart contenus dans une zone.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation par programmation de la WebParts propriété sur un WebPartZone contrôle. Pour obtenir l’exemple de code complet, y compris le fichier source code-behind et la page .aspx qui contient la zone dans ce code, consultez la vue d’ensemble de la WebPartZoneBase classe.

L’exemple de code suivant accède à la WebParts propriété par programmation et affiche une liste des contrôles contenus dans WebPartZone1. Une fois que vous avez chargé la page dans un navigateur, cliquez sur le bouton intitulé List WebPartZone1 WebParts. Les ID et types des contrôles s’affichent.

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

Remarques

La WebParts propriété peut contenir des références à des contrôles qui héritent directement de la WebPart classe, ainsi que d’autres contrôles serveur ASP.NET ou contrôles personnalisés au sein d’une zone. Le jeu de contrôles WebPart encapsule dynamiquement tout contrôle qui n’est pas un WebPartGenericWebPart contrôle en tant que contrôle au moment de l’exécution ; ce mécanisme vous permet d’utiliser tous les types de contrôles ASP.NET comme contrôles WebPart.

Voir aussi

• WebParts
• contrôles de composants WebPart ASP.NET