Control.RenderControl Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Sunucu denetimi içeriğinin çıkışını alır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

Aşırı Yüklemeler

RenderControl(HtmlTextWriter)	Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.
RenderControl(HtmlTextWriter, ControlAdapter)	Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır.

RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

C#

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

Parametreler

writer

HtmlTextWriter

HtmlTextWriter Denetim içeriğini alan nesne.

Örnekler

Aşağıdaki örnek, özel bir sunucu denetiminde yöntemini geçersiz kılar RenderChildren . Geçerli denetimin nesnesinde ControlCollection alt denetim olup olmadığını belirler. Bunu yaparsa, koleksiyonunda yinelemek için özelliğini kullanır Count . Her alt denetimle karşılaştığında RenderControl , alt denetimi ve tüm alt denetimlerini içeren sayfaya işlemek için yöntemini kullanır. XhtmlTextWriter Bu yönteme geçirilen nesnenin örneği yöntemi tarafından Render oluşturulur.

C#

// 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);
}

Açıklamalar

Bir sunucu denetiminin Visible özelliği olarak trueayarlanırsa, bu yöntem sayfa için izlemenin etkinleştirilip etkinleştirilmediğini belirler. Öyleyse, denetimle ilişkili izleme bilgilerini depolar ve sunucu denetimi içeriğini sayfaya işler.

Bu yöntem işleme sırasında sayfa tarafından otomatik olarak çağrılır, ancak özel denetim geliştiricileri tarafından geçersiz kılınabilir.

Ayrıca bkz.

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır.

C#

protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);

Parametreler

writer

HtmlTextWriter

HtmlTextWriter Denetim içeriğini alan.

adapter

ControlAdapter

İşlemeyi ControlAdapter tanımlayan.

Açıklamalar

ASP.NET Web sayfaları, Web'den bilgi isteyebilen çok çeşitli cihazlarda ve tarayıcılarda kullanılabilir. özelliği, Adapter istekte bulunan cihaz veya tarayıcının ekranında denetimi işleyen nesneyi döndürür ControlAdapter .

Bağdaştırıcılar hakkında daha fazla bilgi için bkz. Uyarlamalı Denetim Davranışına Mimari Genel Bakış.

Sunucu denetiminin Visible özelliği olarak true ayarlanırsa ve sayfa için izleme etkinleştirilirse, denetimle ilişkili izleme bilgileri yakalanır.

Devralanlara Notlar

Özel denetimlerde yöntemini geçersiz kıldığınızda RenderControl(HtmlTextWriter, ControlAdapter) , izleme bilgilerinin doğru şekilde yakalandığından emin olmak için temel sınıf yöntemini çağırın.

Ayrıca bkz.

• Adapter
• ControlAdapter
• Trace
• Uyarlamalı Denetim Davranışına Mimari Genel Bakış