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 örnek, sınıfından WebControl türetilen bir sınıfın nasıl oluşturulacağını gösterir. Çıkış akışındaki AddAttributesToRender türetilmiş sınıfa HtmlTextWriter uygun öznitelikler eklemek için yönteminin temel uygulaması 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 denetimi için öznitelikleri ve stilleri işlemek için, genellikle çıkış akışına AddAttribute her özniteliği ve stili tek tek 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 türetilmiş sınıflardaki denetim geliştiricileri tarafından sınıfın çıkış akışına uygun öznitelikleri ve stilleri HtmlTextWriter eklemek için 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.