ChtmlTextWriter.OnAttributeRender Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, отображается ли указанный атрибут 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.
Связанный HtmlTextWriterAttribute с name.
Возвращаемое значение
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 класса.