WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Methode

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Hiermee wordt het hoofdinhoudsgebied van een WebPart besturingselement weergegeven, met uitzondering van de kop- en voettekst.

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)

Parameters

writer
HtmlTextWriter

De HtmlTextWriter inhoud die de webPart inhoud ontvangt.

webPart
WebPart

Het besturingselement dat momenteel wordt weergegeven.

Voorbeelden

Het volgende codevoorbeeld laat het gebruik van de RenderPartContents methode zien. Zie de sectie Voorbeeld van het WebPartChrome onderwerp Class Overview voor de volledige code die is vereist om het voorbeeld uit te voeren.

In de volgende sectie uit het codevoorbeeld ziet u hoe u de RenderPartContents methode overschrijft. De overschreven methode doet twee dingen om de rendering voor de hoofdtekst van het WebPart besturingselement aan te passen. Eerst wordt gecontroleerd of het besturingselement momenteel is geselecteerd, en als dat het geval is, wordt een tekenreeks weggeschreven en wordt de inhoud niet weergegeven. Ten tweede, als het besturingselement niet is geselecteerd en als de zone van het besturingselement van het type MyZoneis, geeft de methode het besturingselement weer. Deze laatste controle kan worden gebruikt als u ervoor wilt zorgen dat een aangepaste WebPartChrome klasse alleen kan worden gebruikt om besturingselementen weer te WebPart geven in een specifiek type WebPartZone zone dat is ontworpen om het WebPartChrome object te bevatten.

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

Als u de webpagina in een browser laadt, kunt u zien dat de inhoud van elk besturingselement normaal wordt weergegeven. Als u de pagina overschakelt naar de ontwerpmodus (door Ontwerp te selecteren in de vervolgkeuzelijst weergavemodus ) en een van de besturingselementen naar de lege zone met het label WebPartZone2 te slepen, wordt de inhoud van het besturingselement anders weergegeven, omdat het aangepaste WebPartChrome object niet wordt gebruikt voor de rendering in een standaardzone. Dit is hetzelfde effect dat u zou bereiken als u de aangepaste WebPartChrome klasse probeerde te gebruiken met een andere zone dan de MyZone klasse, vanwege de voorgaande broncode.

Opmerkingen

Met de RenderPartContents methode kunt u de weergave van het hoofdgedeelte webPartvan , terwijl u de weergave van de kop- en voettekst op de standaardweergave laat staan.

Notities voor overnemers

U kunt de RenderPartContents(HtmlTextWriter, WebPart) methode desgewenst overschrijven. Zo ja, dan kunt u gewoon de gewenste renderingsaanpassingen webPartuitvoeren en vervolgens de RenderControl(HtmlTextWriter) methode aanroepen. Als u ook wilt vertrouwen op de standaardweergave in het geval van verbindingsfouten, roept u eerst de basismethode aan en past u vervolgens de writer geretourneerde methode aan vanuit de basismethode.

Van toepassing op

Zie ook