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 auflisten. 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 Webparts-Steuerelementsatz umschließt jedes Steuerelement, das kein WebPart Steuerelement ist, dynamisch als GenericWebPart Steuerelement zur Laufzeit. Mit diesem Mechanismus können Sie alle Typen von ASP.NET-Steuerelementen als Webparts-Steuerelemente verwenden.

Weitere Informationen

• WebParts
• ASP.NET Webparts-Steuerelemente