WebPartZoneBase.WebParts Propriété

  • Référence

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 programmatique 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 de 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. Après avoir chargé la page dans un navigateur, cliquez sur le bouton Intitulé List WebPartZone1 WebParts. Les ID et les types des contrôles sont affichés.

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 aux contrôles qui héritent directement de la WebPart classe, ainsi que d’autres contrôles serveur ASP.NET ou contrôles personnalisés dans une zone. Le jeu de contrôles composants WebPart encapsule dynamiquement tout contrôle qui n’est pas un WebPart GenericWebPart 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 en tant que contrôles composants WebPart.

S’applique à

Voir aussi