Control.RenderControl Yöntem

Tanım

Sunucu denetimi içeriğini çıkarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.Outputs server control content and stores tracing information about the control if tracing is enabled.

Aşırı Yüklemeler

RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan bir nesneye çıkarır HtmlTextWriter ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter)

Belirtilen bir nesne kullanarak, belirtilen bir nesne için sunucu denetimi içeriğini çıkarır HtmlTextWriter ControlAdapter .Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan bir nesneye çıkarır HtmlTextWriter ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

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)

Parametreler

writer
HtmlTextWriter

HtmlTextWriterDenetim içeriğini alan nesne.The HtmlTextWriter object that receives the control content.

Örnekler

Aşağıdaki örnek, RenderChildren özel bir sunucu denetimindeki yöntemi geçersiz kılar.The following example overrides the RenderChildren method in a custom server control. Geçerli denetimin kendi nesnesinde herhangi bir alt denetime sahip olup olmadığını belirler ControlCollection .It determines whether the current control has any child controls in its ControlCollection object. Varsa, Count koleksiyonunu yinelemek için özelliğini kullanır.If it does, it uses the Count property to iterate through the collection. Her bir alt denetimi karşılaştığı için, alt RenderControl denetimi ve tüm alt denetimlerini kapsayan sayfaya işlemek için yöntemini kullanır.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. XhtmlTextWriterBu yönteme geçirilen nesne, yöntemi tarafından oluşturulur Render .The XhtmlTextWriter object that is passed to this method is instantiated by the Render method.

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

Açıklamalar

Sunucu denetiminin Visible özelliği olarak ayarlandıysa true , bu yöntem izlemenin sayfa için etkin olup olmadığını belirler.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Bu durumda, denetimle ilişkili izleme bilgilerini depolar ve sunucu denetimi içeriğini sayfaya işler.If so, it stores trace information associated with the control, and renders the server control content to the page.

Bu yöntem, oluşturma sırasında sayfa tarafından otomatik olarak çağrılır, ancak özel denetim geliştiricileri tarafından geçersiz kılınabilir.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Ayrıca bkz.

Şunlara uygulanır

RenderControl(HtmlTextWriter, ControlAdapter)

Belirtilen bir nesne kullanarak, belirtilen bir nesne için sunucu denetimi içeriğini çıkarır HtmlTextWriter ControlAdapter .Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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)

Parametreler

writer
HtmlTextWriter

HtmlTextWriterDenetim içeriğini alan.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter

ControlAdapterOluşturmayı tanımlayan.The ControlAdapter that defines the rendering.

Açıklamalar

ASP.NET Web sayfaları, Web 'den bilgi isteyebileceği çok sayıda cihaz ve tarayıcı arasında kullanılabilir.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. AdapterÖzelliği, ControlAdapter istenen cihazda veya tarayıcı ekranında denetimi işleyen nesneyi döndürür.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Bağdaştırıcılar hakkında daha fazla bilgi için bkz. uyarlamalı denetim davranışına mimari genel bakış.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Sunucu denetimi Visible özelliği olarak ayarlanmışsa true ve sayfa için izleme etkinse, denetimle ilişkili izleme bilgileri yakalanır.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Devralanlara Notlar

RenderControl(HtmlTextWriter, ControlAdapter)Özel denetimlerde yöntemi geçersiz kıldığınızda, izleme bilgilerinin doğru yakalandığından emin olmak için temel sınıf yöntemini çağırın.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Ayrıca bkz.

Şunlara uygulanır