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

Определение

Определяет будет ли указанный элемент разметки визуализирован запрашиваемой странице.Determines whether the specified markup element will be rendered to the requesting page.

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

Строка, содержащая имя элемента для визуализации.A string containing the name of the element to render.

key
HtmlTextWriterTag

HtmlTextWriterTag, связанный с элементом.The HtmlTextWriterTag associated with the element.

Возвраты

Всегда true.Always true.

Примеры

В следующем примере кода показано, как переопределить OnTagRender метод.The following code example shows how to override the OnTagRender method. Если элемент подготавливается к просмотру OnTagRender , то переопределение использует IsAttributeDefined метод, чтобы Size определить, визуализируется ли атрибут. FontIf a Font element is being rendered, the OnTagRender override uses the IsAttributeDefined method to determine whether a Size attribute is being rendered. В противном случае он использует AddAttribute метод, чтобы Size создать атрибут 20ptи присвоить ему значение.If not, it uses the AddAttribute method to create a Size attribute and set its value to 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 trueкласса методавсегдавозвращаетзначение.OnTagRenderThe HtmlTextWriter class implementation of the OnTagRender method always returns true. OnTagRender Переопределения могут определять, будет ли элемент отображаться на странице.The OnTagRender overrides can determine whether an element will be rendered to the page.

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

При наследовании от HtmlTextWriter класса можно переопределить метод, чтобы он OnTagRender(String, HtmlTextWriterTag) возвращал false , чтобы элемент разметки не отображался вообще или для конкретного языка разметки.If you inherit from the HtmlTextWriter class, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false to prevent a markup element from being rendered at all or for a particular markup language. Например, если не требуется, HtmlTextWriter чтобы объект, производный от, <font> отображал элемент OnTagRender(String, HtmlTextWriterTag) , можно переопределить метод для возврата false при запросе страницы, содержащей <font> элемент.For example, if you do not want the object that is derived from HtmlTextWriter to render the <font> element, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false when a page is requested that contains a <font> element.

Применяется к

Дополнительно