HtmlTextWriter.OnAttributeRender Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

Определяет, могут ли быть визуализированы указанные атрибут разметки и его значение текущему элемент разметки.

protected:
 virtual bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool

Protected Overridable Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Параметры

name

String

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

value

String

Строка, содержащая значение назначенное атрибуту.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute, связанный с атрибутом разметки.

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

Boolean

Всегда true.

Примеры

В следующем примере кода показано, как переопределить OnAttributeRender метод . Size Если атрибут отображается, но Size значение не 30ptравно , OnAttributeRender переопределение вызывает AddAttribute метод для добавления атрибута Size и задает для его значения значение 30pt.

// If a size attribute is to be rendered, compare its value to 30 point.
// If it is not set to 30 point, add the attribute and set the value to 30,
// then return false.
protected override bool OnAttributeRender(string name,
    string value,
    HtmlTextWriterAttribute key)
{

    if (key == HtmlTextWriterAttribute.Size)
    {
        if (string.Compare(value, "30pt") != 0)
        {
            AddAttribute("size", "30pt");
            return false;
        }
    }

    // If the attribute is not a size attribute, use
    // the base functionality of the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' If a size attribute is to be rendered, compare its value to 30 point.
' If it is not set to 30 point, add the attribute and set the value to 30
' then return false.
Protected Overrides Function OnAttributeRender(name As String, _
    value As String, _
    key As HtmlTextWriterAttribute) _
As Boolean

    If key = HtmlTextWriterAttribute.Size Then
        If [String].Compare(value, "30pt") <> 0 Then
            AddAttribute("size", "30pt")
            Return False
        End If
    End If

    ' If the attribute is not a size attribute, use
    ' the base functionality of the OnAttributeRender method.
    Return MyBase.OnAttributeRender(name, value, key)
End Function 'OnAttributeRender

Комментарии

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

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

При наследовании от HtmlTextWriter класса можно переопределить OnAttributeRender(String, String, HtmlTextWriterAttribute) метод для возврата false , чтобы предотвратить отрисовку атрибута, отрисовку в определенном элементе или отрисовку для определенной разметки. Например, если вы не хотите, чтобы объект, производный от HtmlTextWriter , преобразовывал OnAttributeRender(String, String, HtmlTextWriterAttribute)bgcolor атрибут <table> в элементы, можно переопределить и возвращать при namefalse прохождении bgcolorTagName и значение свойства равно .table

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

• TextWriter
• HtmlTextWriterAttribute