HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет будет ли указанный элемент разметки визуализирован запрашиваемой странице.
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
Параметры
- name
- String
Строка, содержащая имя элемента для визуализации.
Представление HtmlTextWriterTag, связанное с элементом.
Возвращаемое значение
Всегда true.
Примеры
В следующем примере кода показано, как переопределить OnTagRender метод .
Font При отрисовке OnTagRender элемента переопределение использует метод , IsAttributeDefined чтобы определить, выполняется ли Size отрисовка атрибута. В противном случае он использует AddAttribute метод для создания атрибута Size и установки его значения 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
Комментарии
Реализация HtmlTextWriterOnTagRender класса метода всегда возвращает true. Переопределения OnTagRender могут определить, будет ли элемент отображаться на странице.
Примечания для тех, кто наследует этот метод
При наследовании от HtmlTextWriter класса можно переопределить OnTagRender(String, HtmlTextWriterTag) метод для возврата false , чтобы предотвратить отрисовку элемента разметки вообще или для определенного языка разметки. Например, если вы не хотите, чтобы <font> объект, производный от HtmlTextWriter , отображал OnTagRender(String, HtmlTextWriterTag) элемент, можно переопределить метод для возврата false при запросе страницы<font>, содержащей элемент .