HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Определяет будет ли указанный элемент разметки визуализирован запрашиваемой странице.

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

Строка, содержащая имя элемента для визуализации.

key

HtmlTextWriterTag

Представление HtmlTextWriterTag, связанное с элементом.

Возвращаемое значение

Boolean

Всегда 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>, содержащей элемент .

См. также раздел

• TextWriter
• HtmlTextWriterTag