WebPartZoneCollection Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der WebPartZoneCollection-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 Webpart-Steuerelementsatz oder von benutzerdefiniertem 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 seines eigenen Konstruktors, um eine neue Instanz der WebPartZoneCollection Klasse für eine Webpartseite zu initialisieren.
Weitere Informationen
Gilt für:
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.WebPartZoneCollectionPublic Sub New (webPartZones As ICollection)Parameter
- webPartZones
- ICollection
Ein ICollection Objekt WebPartZone .
Ausnahmen
Die Sammlung von Zonen ist null.
Eines der Objekte in der Auflistung ist null oder nicht vom Typ WebPartZone.
Beispiele
Im folgenden Codebeispiel wird die Verwendung des WebPartZoneCollection Konstruktors veranschaulicht. Der vollständige Code für das Beispiel befindet sich im Abschnitt "Beispiel" der WebPartZoneCollection Klassenübersicht.
Beachten Sie im folgenden Codeabschnitt, dass ein WebPartZoneCollection Objekt einer Variablen zugewiesen wird, indem der Wert der Zones Eigenschaft abgerufen wird. Wenn Sie möchten, anstatt alle Zonen aus der Zones Eigenschaft zuzuweisen, könnten Sie ein Array von WebPartZoneBase Objekten erstellen, die eine Teilmenge aller Zonen auf der Seite enthalten, 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 Sammlung erstellt wurde, können Sie die Sammlung ganz einfach durchlaufen und Vorgänge für alle enthaltenen Zonen oder deren Inhalt ausführen. Um den Beispielcode auszuführen, laden Sie die Seite in einem Browser, und klicken Sie auf die Schaltfläche " Verb rendermodus umschalten " in jeder Zone. Dadurch wird abgewechselt, wie die Verben in der Titelleiste jedes Serversteuerelements, das in einer Zone enthalten ist, 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 auszuführen. Sie können beispielsweise 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 dieser Teilmenge von Zonen ausführen.
