WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Methode

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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 -> unit

Protected 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 der gleiche 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.

Weitere Informationen

• ASP.NET Webparts-Steuerelemente