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 ein WebPartZoneBase-Objekt, das dem WebPartChrome-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 dem Objekt derzeit zugeordnete WebPartChrome Zone eine Zone vom Typ MyZoneist. In diesem Fall wird der Inhalt des Steuerelements gerendert. Dieser Code würde verhindern, dass das benutzerdefinierte WebPartChrome Objekt mit einer anderen Zone außer der zum Erstellen einer Instanz des Objekts arbeitet.
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, wird dessen Inhalt anders gerendert, da das benutzerdefinierte WebPartChrome Objekt nicht für das Rendering verwendet wird. Dies ist derselbe Effekt, den Sie aufgrund des vorherigen Quellcodes erzielen würden, wenn Sie versuchen würden, die benutzerdefinierte WebPartChrome Klasse mit einer anderen Zone neben der MyZone -Klasse zu verwenden.
Hinweise
Die Zone -Eigenschaft stellt einen Verweis auf die WebPartZoneBase Zone bereit, die die Steuerelemente enthält, für die das WebPartChrome Objekt renderingt.
