ChtmlTextWriter.OnAttributeRender Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

Определяет, визуализируются ли указанный cHTML-атрибут и его значение на запрашиваемой странице. Можно переопределить метод OnAttributeRender(String, String, HtmlTextWriterAttribute) в классах, производных от класса ChtmlTextWriter для фильтрации атрибутов, которые не нужно визуализировать на устройствах, поддерживающих cHTML.

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

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

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

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

Параметры

name

String

Визуализируемый cHTML-атрибут.

value

String

Значение, назначенное name.

key

HtmlTextWriterAttribute

Класс HtmlTextWriterAttribute, связанный с name.

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

Boolean

true для записи атрибута и его значения в исходящий поток ChtmlTextWriter; в противном случае — значение false.

Примеры

В следующем примере кода показано, как использовать пользовательский класс, который переопределяет OnAttributeRender метод, чтобы запретить bgcolor атрибут из, записываемый в исходящий cHTML поток. Затем он вызывает функциональные возможности, предоставляемые базовым OnAttributeRender методом из ChtmlTextWriter класса , чтобы убедиться, что используется его поведение по умолчанию.

Этот пример входит в состав более крупного примера использования класса ChtmlTextWriter.

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

Комментарии

По умолчанию OnAttributeRender метод предотвращает глобально запрещенных атрибутов, которые перечислены в GlobalSuppressedAttributes свойства и атрибуты конкретного элемента, подавляется, перечисленных в SuppressedAttributes свойство из, записываемый в исходящий поток. Поведение метода можно переопределить в классах OnAttributeRender , производных от ChtmlTextWriter класса .

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

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)