WebControl.AddAttributesToRender(HtmlTextWriter) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Belirtilen HtmlTextWriterTagöğesine işlenmesi gereken HTML öznitelikleri ve stilleri ekler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

protected:
 virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);
abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)

Parametreler

writer
HtmlTextWriter

HtmlTextWriter İstemcide HTML içeriğini işlemek için çıkış akışını temsil eden bir.

Örnekler

Aşağıdaki örnekte sınıfından türetilen bir sınıfın nasıl oluşturulacağı gösterilmektedir WebControl . Yöntemin temel uygulaması, çıkış akışındaki AddAttributesToRender türetilmiş sınıfa HtmlTextWriter uygun öznitelikler eklemek için geçersiz kılınır.

namespace ControlTest 
{
   using System;
   using System.Web.UI;
   using System.Web.UI.WebControls;

   // Renders the following HTML: 
   // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>

   public class MyWebControl: WebControl {

      public MyWebControl() : base(HtmlTextWriterTag.Span) 
      { }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void AddAttributesToRender(HtmlTextWriter writer) 
      {

         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
         base.AddAttributesToRender(writer);
      }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void RenderContents(HtmlTextWriter writer) 
      {
         writer.Write("Custom Contents");
         base.RenderContents(writer);
      }
   }
}


Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace ControlTest
   
   ' Renders the following HTML: 
   ' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
   Public Class MyWebControl
      Inherits WebControl
      
      
      Public Sub New()
         MyBase.New(HtmlTextWriterTag.Span)
      End Sub
      
      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
         
         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
         MyBase.AddAttributesToRender(writer)

      End Sub

      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
         writer.Write("Custom Contents")
         MyBase.RenderContents(writer)
      End Sub

   End Class

End Namespace 'ControlTest

Açıklamalar

İstemcideki bir Web Sunucusu denetimine yönelik öznitelikleri ve stilleri işlemek için, genellikle çıkış akışına AddAttribute her özniteliği ve stili ayrı ayrı eklemek için HtmlTextWriter ve HtmlTextWriter.AddStyleAttribute yöntemlerini çağırırsınız. İşlemi basitleştirmek için bu yöntem, Web sunucusu denetimiyle ilişkili her öznitelik ve stil için ve HtmlTextWriter.AddStyleAttribute yöntemlerine yapılan tüm çağrıları HtmlTextWriter.AddAttribute kapsüller. Tüm öznitelikler ve stiller tek bir yöntem çağrısında HtmlTextWriter çıkış akışına eklenir. Bu yöntem genellikle sınıf için çıkış akışına uygun öznitelikleri ve stilleri HtmlTextWriter eklemek üzere türetilmiş sınıflardaki denetim geliştiricileri tarafından geçersiz kılınır.

Not

AddAttributesToRender yöntemi istemci betiği eklemek için kullanılamaz. İstemci betiğini kullanmak için sınıfına ClientScriptManager bakın.

Şunlara uygulanır

Ayrıca bkz.