Control.RenderControl Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Vypíše obsah řízení serveru a uloží informace o trasování ovládacího prvku, pokud je trasování povolené.

Přetížení

RenderControl(HtmlTextWriter)	Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno.
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.

RenderControl(HtmlTextWriter)

Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno.

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);

abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parametry

writer

HtmlTextWriter

Objekt HtmlTextWriter , který přijímá obsah ovládacího prvku.

Příklady

Následující příklad přepíše metodu RenderChildren ve vlastním serverovém ovládacím prvku. Určuje, zda aktuální ovládací prvek má ve svém ControlCollection objektu nějaké podřízené ovládací prvky. Pokud ano, použije Count vlastnost k iteraci kolekcí. Když narazí na každý podřízený ovládací prvek, použije metodu RenderControl k vykreslení podřízeného ovládacího prvku a všech jeho podřízených ovládacích prvků na stránku, která obsahuje. Objekt XhtmlTextWriter , který je předán této metodě je vytvořena Render pomocí metody .

// Override default implementation to Render children according to needs. 
protected override void RenderChildren(HtmlTextWriter output)
{
   if (HasControls())
   {
      // Render Children in reverse order.
      for(int i = Controls.Count - 1; i >= 0; --i)
      {
         Controls[i].RenderControl(output);
      }
   }         
}

protected override void Render(HtmlTextWriter output)
{       
   output.Write("<br>Message from Control : " + Message);       
   output.Write("Showing Custom controls created in reverse" +
                                                    "order");         
   // Render Controls.
   RenderChildren(output);
}

' Override default implementation to Render children according to needs. 
      Protected Overrides Sub RenderChildren(output As HtmlTextWriter)
         If HasControls() Then
            ' Render Children in reverse order.
            Dim i As Integer

            For i = Controls.Count - 1 To 0 Step -1
               Controls(i).RenderControl(output)
            Next

         End If
      End Sub
      
      
      Protected Overrides Sub Render(output As HtmlTextWriter)
         output.Write(("<br>Message from Control : " + Message))
         output.Write(("Showing Custom controls created in reverse" + "order"))
         ' Render Controls.
         RenderChildren(output)
      End Sub
   End Class

Poznámky

Pokud je vlastnost serverového Visible ovládacího prvku nastavena na truehodnotu , tato metoda určuje, zda je pro stránku povoleno trasování. Pokud ano, uloží informace o trasování přidružené k ovládacímu prvku a vykreslí obsah serverového ovládacího prvku na stránku.

Tato metoda je automaticky volána stránkou během vykreslování, ale mohou ji přepsat vývojáři vlastních ovládacích prvků.

Viz také

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);

protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);

member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit

Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

Parametry

writer

HtmlTextWriter

Hodnota HtmlTextWriter , která obdrží obsah ovládacího prvku.

adapter

ControlAdapter

Hodnota ControlAdapter , která definuje vykreslování.

Poznámky

ASP.NET webové stránky jsou použitelné na široké škále zařízení a prohlížečů, které si můžou vyžádat informace z webu. Vlastnost Adapter vrátí ControlAdapter objekt, který vykresluje ovládací prvek na obrazovce požadovaného zařízení nebo prohlížeče.

Další informace o adaptérech najdete v tématu Přehled architektury chování adaptivního řízení.

Pokud je vlastnost serverového Visible ovládacího prvku nastavená na true a pro stránku je povoleno trasování, zachytí se informace o trasování přidružené k ovládacímu prvku.

Poznámky pro dědice

Při přepsání RenderControl(HtmlTextWriter, ControlAdapter) metody ve vlastních ovládacích prvcích volejte metodu základní třídy, aby se zajistilo správné zachycení informací o trasování.

Viz také

• Adapter
• ControlAdapter
• Trace
• Architektonický přehled chování adaptivního řízení