Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

WebPart.Zone-Eigenschaft

 

Ruft die WebPartZoneBase-Zone ab, die derzeit ein WebPart-Steuerelement enthält.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

[BrowsableAttribute(false)]
public WebPartZoneBase Zone { get; }

Eigenschaftswert

Type: System.Web.UI.WebControls.WebParts.WebPartZoneBase

Die WebPartZoneBase, die derzeit ein Webparts-Steuerelement auf einer Webseite enthält.Wenn ein Webparts-Steuerelement auf einer Seite derzeit geschlossen ist, lautet der Rückgabewert null.

In der Architektur des Webparts-Steuerelementsatzes können Steuerelemente nur dann Webparts-Funktionen besitzen, wenn sie sich innerhalb von WebPartZoneBase-Zonen befinden.Die auf Webseiten zu verwendende WebPartZoneBase-Standardzone ist das WebPartZone-Steuerelement.Endbenutzer können Webparts-Steuerelemente zwar zwischen verschiedenen Zonen auf einer Webseite verschieben, eine bestimmte Instanz eines Steuerelements kann sich jedoch jeweils nur in einer Zone befinden.Ein Webparts-Steuerelement und das ihm zugeordnete WebPartManager-Steuerelement verfolgen mithilfe der Zone-Eigenschaft nach, in welcher Zone sich das Steuerelement derzeit befindet und welche gemeinsamen Layout- und Stilmerkmale der Zone für alle in ihr enthaltenen Webparts-Steuerelemente gelten.

Im folgenden Codebeispiel wird veranschaulicht, wie auf die Zone-Eigenschaft und die ZoneIndex-Eigenschaft für ein benutzerdefiniertes Webparts-Steuerelement zugegriffen wird.In diesem Beispiel wird von der Verwendung des benutzerdefinierten Steuerelements TextDisplayWebPart ausgegangen, das im Beispielabschnitt der Übersicht über die WebPart-Klasse erstellt wurde.

Das Codebeispiel umfasst ein benutzerdefiniertes Benutzersteuerelement, das es Benutzern ermöglicht, den Anzeigemodus auf einer Webparts-Seite zu ändern.Auf das Benutzersteuerelement wird mittels einer Register-Direktive im oberen Bereich der Webseite verwiesen, die das Benutzersteuerelement hostet.Ausführliche Anweisungen zum Erstellen dieses Benutzersteuerelements und zur Arbeit mit Anzeigemodi finden Sie unter Walkthrough: Developing and Using a Custom Web Server Control.

Der zweite Teil des Codebeispiels ist die Webseite.Auf der Seite gibt es zwei <asp:webpartzone>-Elemente, die jeweils eine Webparts-Zone darstellen.Die erste Zone enthält ein Calendar-Standardsteuerelement, das zur Laufzeit als WebPart-Steuerelement fungiert, da es sich in einer Zone befindet.Die zweite Zone enthält das TextDisplayWebPart-Steuerelement.Wenn auf die Schaltfläche Zoneninformationen geklickt wird, zeigt das Label1-Steuerelement die Werte der ZoneIndex-Eigenschaft für das Steuerelement und der ID-Eigenschaft der Zone an, die das Steuerelement derzeit enthält.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: