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

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

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

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

Поделиться через