HtmlTextWriter.AddAttribute Метод

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute(string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Параметры

Примеры

В следующем примере кода показано, как вызвать AddAttribute метод перед вызовом RenderBeginTag метода. Код вызывает две разные перегрузки и две разные перегрузки AddAttributeAddStyleAttribute перед вызовом RenderBeginTag метода для отрисовки <span> элемента в выходной поток. Метод AddAttribute(String, String) используется для определения именованного CustomAttribute пользовательского атрибута и настраиваемого значения, именуемого CustomAttributeValue для <span> элемента, отображаемого этим кодом.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Комментарии

AddAttribute Используйте перегрузку AddAttribute(String, String) метода, если атрибут не является одним из HtmlTextWriterAttribute значений, или если атрибут не известен до времени выполнения.

Для экземпляра любого заданного элемента HtmlTextWriter разметки класс сохраняет список атрибутов для этого элемента. RenderBeginTag При вызове метода все атрибуты, добавленные AddAttribute методом, отрисовываются в открывающий тег элемента. Затем список атрибутов удаляется из HtmlTextWriter объекта.

Шаблон кода для элементов разметки отрисовки выглядит следующим образом:

• AddAttribute Используйте метод для добавления атрибутов в элемент.

• Используйте метод RenderBeginTag.

• Используйте другие методы, чтобы отобразить содержимое, найденное между открывающим и закрывающим тегами элемента.

• Используйте метод RenderEndTag.

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

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Параметры

Примеры

В следующем примере кода показано, как использовать AddAttribute перегрузку метода для добавления AddAttribute(HtmlTextWriterAttribute, String) атрибута Onclick в элемент разметки, а затем задать его значение следующему коду ECMAScript:

alert('Hello');

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Комментарии

AddAttribute Используйте перегрузку метода для отрисовки стандартного AddAttribute(HtmlTextWriterAttribute, String) атрибута разметки.

Для экземпляра любого заданного элемента HtmlTextWriter разметки класс сохраняет список атрибутов для этого элемента. RenderBeginTag При вызове метода все атрибуты, добавляемые AddAttribute методом, отображаются в открываемом теге элемента. Затем список атрибутов очищается из списка HtmlTextWriter.

Шаблон кода для элементов разметки отрисовки выглядит следующим образом:

• AddAttribute Используйте метод для добавления атрибутов в элемент.

• Используйте метод RenderBeginTag.

• Используйте другие методы, чтобы отобразить содержимое, найденное между открывающим и закрывающим тегами элемента.

• Используйте метод RenderEndTag.

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

• TextWriter
• RenderBeginTag
• RenderEndTag()

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute(string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Параметры

Примеры

В следующем примере кода показано, как использовать AddAttribute перегрузку AddAttribute(String, String, Boolean) метода, чтобы гарантировать, что настраиваемый атрибут, именованный myattributeи его значение не кодируются для <img> элемента.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Комментарии

AddAttribute Используйте перегрузку AddAttribute(String, String, Boolean) метода, если атрибут не является одним из HtmlTextWriterAttribute значений, или если атрибут не известен, пока не потребуется время выполнения и кодировка.

Для экземпляра любого заданного элемента HtmlTextWriter разметки класс сохраняет список атрибутов для этого элемента. RenderBeginTag При вызове метода все атрибуты, добавленные AddAttribute методом, отрисовываются в открывающий тег элемента. Затем список атрибутов удаляется из HtmlTextWriter объекта.

AddAttribute(String, String, Boolean) Используйте метод с fEncode заданным значениемtrue, если атрибут может содержать кавычки (), меньше знака (<) или амперсанда (>). Вызов метода закодирует атрибут в соответствии с требованиями запрашивающего устройства. fEncode falseЕсли вы знаете, что ни один из этих символов не будет создан, или если вы знаете, что атрибут уже закодирован.

Если тип атрибута имеет значение Style, оно не будет закодировано даже в том случае fEndodetrue. Убедитесь, что значение стиля соответствует CSS и не содержит вредоносный код.

Шаблон кода для элементов разметки отрисовки выглядит следующим образом:

• AddAttribute Используйте метод для добавления атрибутов в элемент.

• Используйте метод RenderBeginTag.

• Используйте другие методы, чтобы отобразить содержимое, найденное между открывающим и закрывающим тегами элемента.

• Используйте метод RenderEndTag.

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

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

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

protected virtual void AddAttribute(string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Параметры

Комментарии

AddAttribute Используйте перегрузку AddAttribute(String, String, HtmlTextWriterAttribute) метода только при наследовании от HtmlTextWriter класса. Он позволяет создавать новые name и key пары для атрибутов.

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

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

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

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Параметры

Примеры

В следующем примере кода показано, как использовать AddAttribute(HtmlTextWriterAttribute, String, Boolean) метод, чтобы гарантировать, что строковое значение, назначенное Alt атрибуту для <img> элемента, закодировано для запрашивающего устройства.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Комментарии

AddAttribute Используйте перегрузку метода для отрисовки стандартного AddAttribute(HtmlTextWriterAttribute, String, Boolean) атрибута разметки с необязательной кодировкой.

Для экземпляра любого заданного элемента HtmlTextWriter разметки класс сохраняет список атрибутов для этого элемента. RenderBeginTag При вызове метода все атрибуты, добавленные AddAttribute элементом, отрисовываются в открывающий тег элемента. Затем список атрибутов удаляется из HtmlTextWriter объекта.

AddAttribute(HtmlTextWriterAttribute, String, Boolean) Используйте метод с fEncode заданным значениемtrue, если атрибут может содержать кавычки (), меньше знака (<) или амперсанда (>). Вызов метода закодирует атрибут в соответствии с требованиями запрашивающего устройства. fEncode falseЕсли вы знаете, что ни один из этих символов не будет создан, или если вы знаете, что атрибут уже закодирован.

Если тип атрибута имеет значение Style, оно не будет закодировано даже в том случае fEncodetrue. Убедитесь, что значение стиля соответствует CSS и не содержит вредоносный код.

Шаблон кода для элементов разметки отрисовки выглядит следующим образом:

• AddAttribute Используйте метод для добавления атрибутов в элемент.

• Используйте метод RenderBeginTag.

• Используйте другие методы, чтобы отобразить содержимое, найденное между открывающим и закрывающим тегами элемента.

• Используйте метод RenderEndTag.

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

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)