HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) 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í.
Určuje, zda se zadaný element revize vykreslí na požadovanou stránku.
protected:
virtual bool OnTagRender(System::String ^ name, System::Web::UI::HtmlTextWriterTag key);
protected virtual bool OnTagRender (string name, System.Web.UI.HtmlTextWriterTag key);
abstract member OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
override this.OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
Protected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean
Parametry
- name
- String
Řetězec obsahující název elementu, který se má vykreslit.
Přidruženo HtmlTextWriterTag k prvku.
Návraty
Vždy hodnota true
.
Příklady
Následující příklad kódu ukazuje, jak přepsat metodu OnTagRender . Font Pokud se vykresluje prvek, OnTagRender přepsání používá metodu IsAttributeDefined k určení, zda Size se atribut vykresluje. Pokud ne, použije metodu AddAttribute k vytvoření Size atributu a nastavení jeho hodnoty na 20pt
.
// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{
if (key == HtmlTextWriterTag.Font)
{
if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
{
AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
return true;
}
}
// If the element is not a <font> element, use
// the base functionality of the OnTagRenderMethod.
return base.OnTagRender(name, key);
}
' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
name As String, _
key As HtmlTextWriterTag) _
As Boolean
If (key = HtmlTextWriterTag.Font) Then
If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
Return True
End If
End If
' If the element is not a <font> element, use
' the base functionality of the OnTagRenderMethod.
Return MyBase.OnTagRender(name, key)
End Function
Poznámky
Implementace HtmlTextWriter třídy OnTagRender metody vždy vrátí true
. Přepsání OnTagRender mohou určit, jestli se prvek na stránku vykresluje.
Poznámky pro dědice
Pokud dědíte z HtmlTextWriter třídy, můžete metodu OnTagRender(String, HtmlTextWriterTag) přepsat, aby se zabránilo false
vykreslení elementu značky vůbec nebo pro určitý jazyk revizí. Pokud například nechcete, aby objekt odvozený z HtmlTextWriter vykresloval <font>
prvek, můžete metodu OnTagRender(String, HtmlTextWriterTag) přepsat, aby se vrátila false
, když je požadována stránka obsahující <font>
prvek.