WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Methode

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

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 aus dem Codebeispiel wird das Überschreiben der RenderPartContents Methode veranschaulicht. Die überschriebene Methode führt zwei Dinge aus, um das Rendering für den Textkörper des WebPart Steuerelements anzupassen. Zunächst überprüft er, ob das Steuerelement derzeit ausgewählt ist, und schreibt in diesem Fall eine Zeichenfolge aus und rendert den Inhalt nicht. 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 WebPartZone Steuerelementen in einem bestimmten Zonentyp verwendet werden kann, der für die Aufnahme des WebPartChrome Objekts vorgesehen 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 der einzelnen Steuerelemente normal gerendert wird. Wenn Sie die Seite in den Entwurfsmodus wechseln (indem Sie im Dropdownlistensteuerelement für den Anzeigemodusdesign auswählen) und eines der Steuerelemente in die leere Zone mit der Bezeichnung WebPartZone2 ziehen, werden die Inhalte des Steuerelements anders gerendert, da das benutzerdefinierte Objekt nicht für das Rendern WebPartChrome in einer Standardzone verwendet wird. Dies ist der gleiche Effekt, den Sie erzielen würden, wenn Sie aufgrund des vorherigen Quellcodes versucht haben, die benutzerdefinierte WebPartChrome Klasse mit einer anderen Zone neben der MyZone Klasse zu verwenden.

Hinweise

Mit der RenderPartContents Methode können Sie das Rendern des Textkörperbereichs webPartaußer Kraft setzen und gleichzeitig das Rendern der Kopf- und Fußzeile auf das Standardrendering verlassen.

Hinweise für Vererber

Optional können Sie die RenderPartContents(HtmlTextWriter, WebPart) Methode außer Kraft setzen. Wenn dies der Grund ist, können Sie einfach alle gewünschten Renderinganpassungen webPartausführen und dann dessen RenderControl(HtmlTextWriter) Methode aufrufen. Wenn Sie sich auch auf das Standardrendering im Falle von Verbindungsfehlern verlassen möchten, rufen Sie zuerst die Basismethode auf, und passen Sie dann das writer von der Basismethode zurückgegebene Anpassen an.

Weitere Informationen

• ASP.NET Webpart-Steuerelemente