Control.RenderControl Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Výstupy serveru řídí obsah a ukládá informace o trasování ovládacího prvku, pokud je povoleno trasování.

Přetížení

RenderControl(HtmlTextWriter)	Výstupem je obsah 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ýstupem je obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu.

RenderControl(HtmlTextWriter)

Výstupem je obsah 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:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

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

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

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

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

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

Public Sub RenderControl (writer As HtmlTextWriter)

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 má aktuální ovládací prvek v objektu ControlCollection jakékoli podřízené ovládací prvky. Pokud ano, použije Count vlastnost k iteraci v kolekci. Když 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ímu prvku a vykresluje obsah ovládacího prvku serveru na stránku.

Tato metoda je automaticky volána stránkou během vykreslování, ale může být přepsána vlastními ovládacími prvky vývojáři.

Viz také

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Výstupem je obsah ovládacího prvku serveru do zadané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

Obsah HtmlTextWriter ovládacího prvku obdrží.

adapter

ControlAdapter

Tím ControlAdapter se definuje vykreslování.

Poznámky

ASP.NET webové stránky lze použít 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 stránku a trasování je pro stránku povolená, 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 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í