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

Параметры

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

Всегда true.

Примеры

В следующем примере кода показано, как переопределить OnTagRender метод. Font Если элемент отрисовывается, переопределение использует OnTagRender метод для определения того, IsAttributeDefined выполняется ли Size отрисовка атрибута. Если нет, метод используется для создания атрибута AddAttributeSize и присвоения ему значения 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

Комментарии

Реализация HtmlTextWriter класса OnTagRender метода всегда возвращается true. OnTagRender Переопределения могут определить, будет ли элемент отображаться на странице.

Примечания для тех, кто наследует этот метод

При наследовании от HtmlTextWriter класса можно переопределить OnTagRender(String, HtmlTextWriterTag) метод, чтобы false предотвратить отрисовку элемента разметки вообще или для определенного языка разметки. Например, если объект, производный от HtmlTextWriter отрисовки <font> элемента, не требуется, можно переопределить OnTagRender(String, HtmlTextWriterTag) метод, возвращаемый false при запросе страницы, содержащей <font> элемент.

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

• TextWriter
• HtmlTextWriterTag