WebPartZoneCollection Konstruktoren

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Initialisiert eine neue Instanz der WebPartZoneCollection-Klasse.

Überlädt

WebPartZoneCollection()	Initialisiert eine leere Instanz der WebPartZoneCollection-Klasse.
WebPartZoneCollection(ICollection)	Initialisiert eine Instanz der WebPartZoneCollection-Klasse, indem eine Auflistung von WebPartZone-Objekten übergeben wird.

Hinweise

Der WebPartZoneCollection Konstruktor wird vom WebPartManager Steuerelement, von anderen Steuerelementen im Webparts-Steuerelementsatz oder vom benutzerdefinierten Entwicklercode verwendet, um eine schreibgeschützte Auflistung der Steuerelemente zu erstellen, die WebPartZone auf einer Webpartseite vorhanden sind.

WebPartZoneCollection()

Initialisiert eine leere Instanz der WebPartZoneCollection-Klasse.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Hinweise

Das WebPartManager Steuerelement verwendet diesen Konstruktor innerhalb eines eigenen Konstruktors, um eine neue Instanz der WebPartZoneCollection -Klasse für eine Webpartseite zu initialisieren.

Weitere Informationen

• ASP.NET Webpart-Steuerelemente

WebPartZoneCollection(ICollection)

Initialisiert eine Instanz der WebPartZoneCollection-Klasse, indem eine Auflistung von WebPartZone-Objekten übergeben wird.

public:
 WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);

public WebPartZoneCollection (System.Collections.ICollection webPartZones);

new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

Parameter

webPartZones

ICollection

Eine ICollection von WebPartZone-Objekten.

Ausnahmen

ArgumentNullException

Die Auflistung der Zonen ist null.

ArgumentException

Eines der Objekte der Auflistung ist null oder ist nicht vom Typ WebPartZone.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des WebPartZoneCollection Konstruktors veranschaulicht. Den vollständigen Code für das Beispiel finden Sie im Abschnitt Beispiel der WebPartZoneCollection Klassenübersicht.

Beachten Sie im folgenden Codeabschnitt, dass ein Objekt einer Variablen zugewiesen WebPartZoneCollection wird, indem der Wert der Zones -Eigenschaft abgerufen wird. Wenn Sie möchten, können Sie nicht alle Zonen aus der Zones -Eigenschaft zuweisen, sondern ein Array von WebPartZoneBase Objekten erstellen, das eine Teilmenge aller Zonen auf der Seite enthält, und das Array einem neuen WebPartZoneCollection Objekt zuweisen.

protected void Button5_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;

  WebPartZoneCollection zoneCollection = mgr.Zones;
  foreach (WebPartZone zone in zoneCollection)
  {

    if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
    else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
  }
}

Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = String.Empty

  Dim zoneCollection As WebPartZoneCollection = mgr.Zones
  Dim zone As WebPartZone
  For Each zone In zoneCollection
    If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
    Else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
    End If
  Next zone

End Sub

Nachdem die Auflistung erstellt wurde, können Sie die Auflistung problemlos durchlaufen und Vorgänge für alle enthaltenen Zonen oder deren Inhalt ausführen. Um den Beispielcode auszuführen, laden Sie die Seite in einen Browser, und klicken Sie auf die Schaltfläche Verb Rendermodus umschalten in jeder Zone. Dadurch wird abgewechselt, wie die Verben in der Titelleiste jedes in einer Zone enthaltenen Serversteuerelements gerendert werden. Die Verben können in einem Dropdownmenü oder direkt als Links in der Titelleiste angezeigt werden.

Hinweise

Verwenden Sie den WebPartZoneCollection Konstruktor, wenn Sie eine benutzerdefinierte Auflistung von WebPartZone Objekten erstellen möchten, um programmgesteuerte Vorgänge für sie auszuführen. Beispielsweise können Sie auf die Zones -Eigenschaft zugreifen und eine Teilmenge von WebPartZone Objekten auf einer Webpartseite erstellen, sie einem WebPartZoneCollection Objekt zuweisen und dann Vorgänge für die untergeordneten Steuerelemente oder verschiedene Eigenschaften nur für diese Teilmenge von Zonen ausführen.

Weitere Informationen

• ASP.NET Webpart-Steuerelemente