WebControl.AddAttributesToRender(HtmlTextWriter) Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá atributy a styly HTML, které je potřeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků.

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)

Parametry

writer: HtmlTextWriter

A HtmlTextWriter , který představuje výstupní datový proud pro vykreslení obsahu HTML na klientovi.

Příklady

Následující příklad ukazuje, jak vytvořit třídu, která je odvozena z WebControl třídy . Základní implementace AddAttributesToRender metody je přepsána přidáním atributů odpovídajících odvozené třídě ve výstupním datovém HtmlTextWriter proudu.

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

Poznámky

Chcete-li vykreslit atributy a styly pro ovládací prvek webového serveru v klientovi, obvykle voláte AddAttribute metody a HtmlTextWriter.AddStyleAttribute metody pro vložení jednotlivých atributů a stylů do výstupního datového HtmlTextWriter proudu. Pro zjednodušení procesu tato metoda zapouzdřuje všechna volání HtmlTextWriter.AddAttribute metod a HtmlTextWriter.AddStyleAttribute pro každý atribut a styl přidružený k ovládacímu prvku webového serveru. Všechny atributy a styly jsou vloženy do výstupního datového HtmlTextWriter proudu v jednom volání metody. Tuto metodu obvykle přepisují vývojáři ovládacích prvků v odvozených třídách k vložení příslušných atributů a stylů do výstupního datového HtmlTextWriter proudu pro třídu.

Poznámka

Metodu AddAttributesToRender nelze použít k vložení klientského skriptu. Pokud chcete použít klientský skript, podívejte se na ClientScriptManager třídu .

Platí pro

Sdílet prostřednictvím