HtmlTextWriter.OnStyleAttributeRender Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, могут ли быть визуализированы указанные атрибут стиля разметки и его значение текущему элемент разметки.
protected:
virtual bool OnStyleAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterStyle key);
protected virtual bool OnStyleAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterStyle key);
abstract member OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool
override this.OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool
Protected Overridable Function OnStyleAttributeRender (name As String, value As String, key As HtmlTextWriterStyle) As Boolean
Параметры
- name
- String
Строка, содержащая имя стиля атрибута для визуализации.
- value
- String
Строка, содержащая значение назначенное атрибуту стиля.
HtmlTextWriterStyle, связанный со стилем атрибута.
Возвращаемое значение
Всегда true
.
Примеры
В следующем примере кода показано, как переопределить OnStyleAttributeRender метод .
Color Если атрибут стиля отображается, но Color значение не purple
равно , OnStyleAttributeRender переопределение использует AddStyleAttribute метод , чтобы задать Color атрибуту значение purple
.
// If a color style attribute is to be rendered,
// compare its value to purple. If it is not set to
// purple, add the style attribute and set the value
// to purple, then return false.
protected override bool OnStyleAttributeRender(string name,
string value,
HtmlTextWriterStyle key)
{
if (key == HtmlTextWriterStyle.Color)
{
if (string.Compare(value, "purple") != 0)
{
AddStyleAttribute("color", "purple");
return false;
}
}
// If the style attribute is not a color attribute,
// use the base functionality of the
// OnStyleAttributeRender method.
return base.OnStyleAttributeRender(name, value, key);
}
' If a color style attribute is to be rendered,
' compare its value to purple. If it is not set to
' purple, add the style attribute and set the value
' to purple, then return false.
Protected Overrides Function OnStyleAttributeRender(name As String, _
value As String, _
key As HtmlTextWriterStyle) _
As Boolean
If key = HtmlTextWriterStyle.Color Then
If [String].Compare(value, "purple") <> 0 Then
AddStyleAttribute("color", "purple")
Return False
End If
End If
' If the style attribute is not a color attribute,
' use the base functionality of the
' OnStyleAttributeRender method.
Return MyBase.OnStyleAttributeRender(name, value, key)
End Function 'OnStyleAttributeRender
Комментарии
Реализация HtmlTextWriterOnStyleAttributeRender класса метода всегда возвращает .true
Переопределения OnStyleAttributeRender могут определить, будет ли атрибут стиля отображаться на странице.
Примечания для тех, кто наследует этот метод
При наследовании от HtmlTextWriter класса можно переопределить OnStyleAttributeRender(String, String, HtmlTextWriterStyle) метод для возврата false
, чтобы предотвратить отрисовку атрибута стиля, отрисовку в определенном элементе или отрисовку для определенного языка разметки. Например, если вы не хотите, чтобы объект, производный от HtmlTextWriter , преобразовывал color
OnStyleAttributeRender(String, String, HtmlTextWriterStyle) атрибут <p>
стиля в элемент, можно переопределить и возвратить false
при name
прохождении color
TagName, а значение свойства равно p
.