WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Methode
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.
Gibt den Hauptinhaltsbereich eines WebPart-Steuerelements wieder und schließt Header und Footer vom Rendering aus.
protected:
virtual void RenderPartContents(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::WebControls::WebParts::WebPart ^ webPart);protected virtual void RenderPartContents (System.Web.UI.HtmlTextWriter writer, System.Web.UI.WebControls.WebParts.WebPart webPart);abstract member RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unitProtected Overridable Sub RenderPartContents (writer As HtmlTextWriter, webPart As WebPart)Parameter
- writer
- HtmlTextWriter
Der HtmlTextWriter, der den Inhalt von webPart empfängt.
- webPart
- WebPart
Das Steuerelement, das gerade gerendert wird.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der RenderPartContents -Methode 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 Abschnitt des Codebeispiels wird veranschaulicht, wie die RenderPartContents -Methode überschrieben wird. Die überschriebene Methode führt zwei Aktionen aus, um das Rendering für den Textkörper des WebPart Steuerelements anzupassen. Zunächst wird überprüft, ob das Steuerelement derzeit ausgewählt ist. Wenn ja, schreibt er eine Zeichenfolge aus und rendert den Inhalt nicht. Zweitens: Wenn das Steuerelement nicht ausgewählt ist und die Zone des Steuerelements vom Typ MyZoneist, rendert die -Methode das Steuerelement. Diese letztere Überprüfung kann verwendet werden, wenn Sie sicherstellen möchten, dass eine benutzerdefinierte WebPartChrome Klasse nur zum Rendern WebPart von Steuerelementen in einem bestimmten Zonentyp verwendet werden kann, der WebPartZone für das WebPartChrome -Objekt konzipiert ist.
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, können Sie sehen, dass der Inhalt jedes Steuerelements normal gerendert wird. Wenn Sie die Seite in den Entwurfsmodus wechseln (indem Sie design im Dropdown-Listensteuerelement Anzeigemodus auswählen) und eines der Steuerelemente in die leere Zone mit der Bezeichnung WebPartZone2 ziehen, wird der Inhalt des Steuerelements anders gerendert, da das benutzerdefinierte WebPartChrome Objekt nicht für das Rendering in einer Standardzone verwendet wird. Dies ist derselbe Effekt, den Sie erzielen würden, wenn Sie versuchen würden, die benutzerdefinierte WebPartChrome Klasse mit einer anderen Zone neben der MyZone -Klasse zu verwenden, aufgrund des vorangehenden Quellcodes.
Hinweise
Mit RenderPartContents der -Methode können Sie das Rendering des Textbereichs von webPartüberschreiben, während das Rendern der Kopf- und Fußzeile dem Standardrendering überlassen bleibt.
Hinweise für Vererber
Optional können Sie die RenderPartContents(HtmlTextWriter, WebPart) -Methode überschreiben. Wenn dies der Grund ist, können Sie einfach beliebige Renderinganpassungen für webPartausführen und dann die - RenderControl(HtmlTextWriter) Methode aufrufen. Wenn Sie sich auch bei Verbindungsfehlern auf das Standardrendering verlassen möchten, rufen Sie zuerst die Basismethode auf, und passen Sie dann die an, die writer von der Basismethode zurückgegeben wird.
