WebPartZoneBase.WebParts Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft die Auflistung von in einer Zone enthaltenen Webparts-Steuerelementen ab.

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

Eigenschaftswert

WebPartCollection

Eine WebPartCollection, die Verweise auf alle Webparts-Steuerelemente in einer Zone enthält.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der WebParts Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Das vollständige Codebeispiel, einschließlich der CodeBehind-Quelldatei und der .aspx Seite, die die Zone in diesem Code enthält, finden Sie in der WebPartZoneBase Klassenübersicht.

Im folgenden Codebeispiel wird programmgesteuert auf die WebParts Eigenschaft zugegriffen und eine Liste der in WebPartZone1enthaltenen Steuerelemente angezeigt. Nachdem Sie die Seite in einen Browser geladen haben, klicken Sie auf die Schaltfläche WebPartZone1 WebParts listen. Die IDs und Typen der Steuerelemente werden angezeigt.

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

Hinweise

Die WebParts -Eigenschaft kann Verweise auf Steuerelemente enthalten, die direkt von der WebPart -Klasse erben, sowie andere ASP.NET-Serversteuerelemente oder benutzerdefinierte Steuerelemente innerhalb einer Zone. Der Webpart-Steuerelementsatz umschließt dynamisch jedes Steuerelement, das kein WebPart Steuerelement ist, zur GenericWebPart Laufzeit. Mit diesem Mechanismus können Sie alle Typen von ASP.NET-Steuerelementen als Webpart-Steuerelemente verwenden.

Weitere Informationen

• WebParts
• ASP.NET Webpart-Steuerelemente