WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vykreslí oblast hlavního obsahu ovládacího prvku WebPart s výjimkou záhlaví a zápatí.

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)

Parametry

writer: HtmlTextWriter

Ten HtmlTextWriter , který přijímá webPart obsah.

webPart: WebPart

Aktuálně vykreslovaný ovládací prvek.

Příklady

Následující příklad kódu ukazuje použití RenderPartContents metody. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v tématu přehledu WebPartChrome třídy.

Následující část z příkladu kódu ukazuje, jak přepsat metodu RenderPartContents . Přepsaná metoda provede dvě věci, aby přizpůsobila vykreslování pro tělo WebPart ovládacího prvku. Nejprve zkontroluje, jestli je ovládací prvek aktuálně vybraný, a pokud ano, zapíše řetězec a nevykreslí obsah. Za druhé, pokud ovládací prvek není vybrán a pokud je zóna ovládacího prvku typu MyZone, metoda vykreslí ovládací prvek. Tuto druhou kontrolu lze použít, pokud chcete zajistit, že vlastní WebPartChrome třídu lze použít pouze k vykreslení WebPart ovládacích prvků v určitém typu WebPartZone zóny, která je navržena tak, aby obsahovala WebPartChrome objekt.

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

Pokud načtete webovou stránku v prohlížeči, uvidíte, že se obsah jednotlivých ovládacích prvků vykresluje normálně. Pokud stránku přepnete do režimu návrhu (výběrem možnosti Návrh v ovládacím prvku rozevíracího seznamu Režim zobrazení ) a přetáhnete jeden z ovládacích prvků do prázdné zóny s popiskem WebPartZone2, bude obsah ovládacího prvku vykreslen odlišně, protože vlastní WebPartChrome objekt se nepoužívá pro vykreslování ve standardní zóně. To je stejný účinek, kterého byste dosáhli, kdybyste MyZone se pokusili použít vlastní WebPartChrome třídu s jakoukoli jinou zónou kromě třídy, a to kvůli předchozímu zdrojovému kódu.

Poznámky

Metoda RenderPartContents umožňuje přepsat vykreslování oblasti webParttextu souboru a ponechat vykreslování záhlaví a zápatí na výchozí vykreslování.

Poznámky pro dědice

Volitelně můžete metodu RenderPartContents(HtmlTextWriter, WebPart) přepsat. Pokud ano, můžete jednoduše provést jakékoli vlastní nastavení vykreslování, které chcete , webParta pak volat jeho RenderControl(HtmlTextWriter) metodu. Pokud chcete také spoléhat na výchozí vykreslování v případě chyb připojení, zavolejte nejprve základní metodu a pak upravte writer , která je vrácena ze základní metody.

Platí pro

Viz také

ASP.NET ovládací prvky webových částí

Sdílet prostřednictvím