WebControl.AddAttributesToRender(HtmlTextWriter) Metoda
Definice
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 na zadaný 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 metody a HtmlTextWriter.AddStyleAttribute vloží každý atribut a styl jednotlivě 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 jediném volání metody. Tuto metodu obvykle přepisují vývojáři ovládacích prvků v odvozených třídách, aby se do výstupního datového HtmlTextWriter proudu pro třídu vložily příslušné atributy a styly.
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
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro