HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Bepaalt of het opgegeven opmaakelement wordt weergegeven op de aanvraagpagina.
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
Parameters
- name
- String
Een tekenreeks met de naam van het element dat moet worden weergegeven.
De HtmlTextWriterTag gekoppelde aan het element.
Retouren
Altijd true.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de OnTagRender methode overschrijft. Als een Font element wordt weergegeven, gebruikt de OnTagRender onderdrukking de IsAttributeDefined methode om te bepalen of een Size kenmerk wordt weergegeven. Als dat niet zo is, wordt de AddAttribute methode gebruikt om een Size kenmerk te maken en de waarde ervan in te stellen op 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
Opmerkingen
De HtmlTextWriter klasse-implementatie van de OnTagRender methode retourneert truealtijd . De OnTagRender onderdrukkingen kunnen bepalen of een element wordt weergegeven op de pagina.
Notities voor overnemers
Als u de klasse overschrijft HtmlTextWriter , kunt u de OnTagRender(String, HtmlTextWriterTag) methode overschrijven om te false voorkomen dat een opmaakelement helemaal wordt weergegeven of voor een bepaalde opmaaktaal. Als u bijvoorbeeld niet wilt dat het object dat is afgeleid van HtmlTextWriter het element weer te geven, kunt u de <font> methode overschrijven die moet worden geretourneerd OnTagRender(String, HtmlTextWriterTag) wanneer een pagina wordt aangevraagd die een false element <font> bevat.