WebPartChrome.Zone Eigenschaft
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.
Ruft einen Verweis auf die zugeordnete WebPartZoneBase Zone ab.
protected:
property System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ Zone { System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ get(); };protected System.Web.UI.WebControls.WebParts.WebPartZoneBase Zone { get; }member this.Zone : System.Web.UI.WebControls.WebParts.WebPartZoneBaseProtected ReadOnly Property Zone As WebPartZoneBaseEigenschaftswert
Ein Verweis auf einen WebPartZoneBase , der dem WebPartChromezugeordneten Objekt zugeordnet ist.
Beispiele
In diesem Codebeispiel wird die Verwendung der Zone Eigenschaft veranschaulicht. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des WebPartChrome Themas "Klassenübersicht".
Im folgenden Codebeispiel wird die Zone Eigenschaft verwendet, um zu bestimmen, ob die aktuell dem WebPartChrome Objekt zugeordnete Zone eine Zone vom Typ MyZoneist. Wenn ja, werden die Inhalte des Steuerelements gerendert. Dieser Code würde verhindern, dass das benutzerdefinierte WebPartChrome Objekt mit einer anderen Zone arbeitet, neben dem, das eine Instanz davon erstellen soll.
protected override void RenderPartContents(HtmlTextWriter writer,
WebPart part)
{
if (part == this.WebPartManager.SelectedWebPart)
HttpContext.Current.Response.Write("<span>Not rendered</span>");
else
if(this.Zone.GetType() == typeof(MyZone))
part.RenderControl(writer);
}
Protected Overrides Sub RenderPartContents _
(ByVal writer As HtmlTextWriter, ByVal part As WebPart)
If part Is Me.WebPartManager.SelectedWebPart Then
HttpContext.Current.Response.Write("<span>Not rendered</span>")
Else
If (Me.Zone.GetType() Is GetType(MyZone)) Then
part.RenderControl(writer)
End If
End If
End Sub
Wenn Sie die Webseite in einem Browser laden, wird der Inhalt jedes Steuerelements normal gerendert. Sie können die Seite in den Entwurfsmodus wechseln, indem Sie im Dropdownlistensteuerelement "Anzeigemodus" die Option "Entwurf" auswählen. Wenn Sie eines der Steuerelemente in die leere Zone mit der Bezeichnung WebPartZone2 ziehen, werden die Inhalte anders gerendert, da das benutzerdefinierte WebPartChrome Objekt nicht für das Rendern verwendet wird. Dies ist derselbe Effekt, den Sie erzielen würden, wenn Sie versucht haben, die benutzerdefinierte WebPartChrome Klasse mit einer anderen Zone neben der MyZone Klasse zu verwenden, aufgrund des vorherigen Quellcodes.
Hinweise
Die Zone Eigenschaft stellt einen Verweis auf die WebPartZoneBase Zone bereit, die die Steuerelemente enthält, für die das WebPartChrome Objekt Rendering bereitstellt.
