Control.RenderControl Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Output konten kontrol server dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.

Overload

RenderControl(HtmlTextWriter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.
RenderControl(HtmlTextWriter, ControlAdapter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .

RenderControl(HtmlTextWriter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.

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)

Parameter

writer

HtmlTextWriter

Objek HtmlTextWriter yang menerima konten kontrol.

Contoh

Contoh berikut mengambil alih RenderChildren metode dalam kontrol server kustom. Ini menentukan apakah kontrol saat ini memiliki kontrol turunan dalam objeknya ControlCollection . Jika ya, ia menggunakan Count properti untuk melakukan iterasi melalui koleksi. Karena menemukan setiap kontrol anak, ia menggunakan RenderControl metode untuk merender kontrol anak, dan semua kontrol anaknya, ke halaman yang berisi. Objek XhtmlTextWriter yang diteruskan ke metode ini diinstansiasi oleh Render metode .

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

Keterangan

Jika properti kontrol Visible server diatur ke true, metode ini menentukan apakah pelacakan diaktifkan untuk halaman. Jika demikian, ia menyimpan informasi pelacakan yang terkait dengan kontrol, dan merender konten kontrol server ke halaman.

Metode ini secara otomatis dipanggil oleh halaman selama penyajian, tetapi dapat ditimpa oleh pengembang kontrol kustom.

Lihat juga

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .

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)

Parameter

writer

HtmlTextWriter

HtmlTextWriter yang menerima konten kontrol.

adapter

ControlAdapter

ControlAdapter yang mendefinisikan penyajian.

Keterangan

ASP.NET Halaman web dapat digunakan di berbagai perangkat dan browser yang dapat meminta informasi dari Web. Properti Adapter mengembalikan ControlAdapter objek yang merender kontrol pada layar perangkat atau browser yang meminta.

Untuk informasi selengkapnya tentang adaptor, lihat Gambaran Umum Arsitektur Perilaku Kontrol Adaptif.

Jika properti kontrol Visible server diatur ke true dan pelacakan diaktifkan untuk halaman, maka informasi pelacakan yang terkait dengan kontrol akan ditangkap.

Catatan Bagi Inheritor

Saat mengambil alih RenderControl(HtmlTextWriter, ControlAdapter) metode dalam kontrol kustom, panggil metode kelas dasar untuk memastikan informasi pelacakan diambil dengan benar.

Lihat juga

• Adapter
• ControlAdapter
• Trace
• Gambaran Umum Arsitektur Perilaku Kontrol Adaptif