Control.RenderControl Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Výstupy obsahu ovládacího prvku serveru a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování.

Přetížení

Name	Description
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování.
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu.

RenderControl(HtmlTextWriter)

Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování.

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 ovládacím prvku serveru. Určuje, zda aktuální ovládací prvek má v objektu ControlCollection jakékoli podřízené ovládací prvky. Pokud ano, použije Count vlastnost k iteraci v kolekci. Jak narazí na každý podřízený ovládací prvek, používá 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 obsahující. Objekt XhtmlTextWriter , který je předán této metodě je vytvořena metodou Render .

// 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 ovládacího prvku Visible serveru nastavena na true, 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ího prvku a vykreslí obsah ovládacího prvku serveru na stránku.

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

Viz také

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnuté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

Ten HtmlTextWriter obdrží obsah ovládacího prvku.

adapter

ControlAdapter

Ten ControlAdapter definuje vykreslování.

Poznámky

ASP.NET webové stránky jsou použitelné v široké škále zařízení a prohlížečů, které mohou požadovat informace z webu. Vlastnost Adapter vrátí ControlAdapter objekt, který vykreslí 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 ovládacího prvku Visible serveru nastavená na true a pro stránku je povoleno trasování, zachytí se informace o trasování přidružené k ovládacího prvku.

Poznámky pro dědice

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

Viz také

• Adapter
• ControlAdapter
• Trace
• Přehled architektury chování adaptivního řízení