Control.RenderControl Metódus

Definíció

Névtér:

System.Web.UI

Szerelvény:

System.Web.dll

A kimenetek a kiszolgálót vezérli, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja.

Túlterhelések

Name	Description
RenderControl(HtmlTextWriter)	A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja.
RenderControl(HtmlTextWriter, ControlAdapter)	A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli.

RenderControl(HtmlTextWriter)

A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja.

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)

Paraméterek

writer

HtmlTextWriter

A HtmlTextWriter vezérlőtartalmat fogadó objektum.

Példák

Az alábbi példa felülírja a RenderChildren metódust egy egyéni kiszolgálóvezérlőben. Meghatározza, hogy az aktuális vezérlő rendelkezik-e gyermekvezérlőkkel az ControlCollection objektumban. Ha igen, a tulajdonságot használja a Count gyűjteményen keresztüli iteráláshoz. Az egyes gyermekvezérlőkkel való találkozáskor a RenderControl metódussal rendereli a gyermekvezérlőt és annak összes gyermekvezérlőjét a szülőoldalon. A XhtmlTextWriter metódusnak átadott objektumot a Render metódus hozza létre.

// 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

Megjegyzések

Ha egy kiszolgálóvezérlő tulajdonsága Visible be van állítva true, ez a módszer határozza meg, hogy engedélyezve van-e a nyomkövetés a lapon. Ha igen, akkor a vezérlőhöz társított nyomkövetési információkat tárolja, és megjeleníti a kiszolgálóvezérlő tartalmát a lapra.

Ezt a metódust a lap a renderelés során automatikusan meghívja, de az egyéni vezérlőfejlesztők felülírhatják.

Lásd még

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli.

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)

Paraméterek

writer

HtmlTextWriter

A HtmlTextWriter vezérlő tartalmát fogadó.

adapter

ControlAdapter

A ControlAdapter renderelést meghatározó.

Megjegyzések

ASP.NET weblapok számos olyan eszközön és böngészőben használhatók, amelyek információt kérhetnek az internetről. A Adapter tulajdonság visszaadja azt az ControlAdapter objektumot, amely a vezérlőt a kérelmező eszköz vagy böngésző képernyőjén jeleníti meg.

Az adapterekkel kapcsolatos további információkért lásd az adaptív vezérlés viselkedésének architekturális áttekintését.

Ha egy kiszolgálóvezérlő tulajdonsága Visible be van állítva true , és a nyomkövetés engedélyezve van a lapon, akkor a rendszer rögzíti a vezérlőhöz társított nyomkövetési információkat.

Megjegyzések az öröklőkhöz

Ha felülírja a metódust az RenderControl(HtmlTextWriter, ControlAdapter) egyéni vezérlőkben, hívja meg az alaposztály metódusát, hogy a nyomkövetési adatok helyesen legyenek rögzítve.

Lásd még

• Adapter
• ControlAdapter
• Trace
• Az adaptív vezérlés viselkedésének architektúra áttekintése