HtmlTextWriter.AddAttribute Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

Перегрузки

AddAttribute(String, String)	Добавляет указанные атрибут и значение разметки в открывающий тег элемента, создаваемого объектом HtmlTextWriter с последующим вызовом метода RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String)	Добавляет атрибут разметки и значение атрибута в открывающий тег элемента, создаваемого объектом HtmlTextWriter с последующим вызовом метода RenderBeginTag.
AddAttribute(String, String, Boolean)	Добавляет указанные атрибут разметки и значение в открывающий тег элемента, создаваемого объектом HtmlTextWriter с последующим вызовом метода RenderBeginTag, с дополнительным кодированием.
AddAttribute(String, String, HtmlTextWriterAttribute)	Добавляет указанные атрибут разметки и значение вместе со значением перечисления HtmlTextWriterAttribute в открывающий тег элемента, создаваемого объектом HtmlTextWriter, с последующим вызовом метода RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Добавляет атрибут разметки и значение атрибута в открывающий тег элемента, создаваемого объектом HtmlTextWriter с последующим вызовом метода RenderBeginTag, с дополнительным кодированием.

AddAttribute(String, String)

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

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)

Параметры

name

String

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

value

String

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

Примеры

В следующем примере кода показано, как вызвать AddAttribute метод перед вызовом RenderBeginTag метода . Код вызывает две разные перегрузки AddAttribute и две разные перегрузки AddStyleAttribute перед вызовом 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

AddAttribute(HtmlTextWriterAttribute, String)

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

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)

Параметры

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute, представляющий атрибут разметки для добавления в исходящий поток.

value

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()

AddAttribute(String, String, Boolean)

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

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)

Параметры

name

String

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

value

String

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

fEndode

Boolean

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

Примеры

В следующем примере кода показано, как использовать 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, если атрибут может содержать кавычки (), знак меньше () или амперсанд< (&). Вызов метода закодирует атрибут в соответствии с требованиями запрашивающего устройства. Можно задать значение fEncodefalse, если известно, что ни один из этих символов не будет создан, или если вы знаете, что атрибут уже закодирован.

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

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

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

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

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

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

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

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

AddAttribute(String, String, HtmlTextWriterAttribute)

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

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)

Параметры

name

String

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

value

String

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

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute, представляющий атрибут.

Комментарии

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

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

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

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

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)

Параметры

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute, представляющий атрибут разметки для добавления в исходящий поток.

value

String

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

fEncode

Boolean

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

Примеры

В следующем примере кода показано, как использовать 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, если атрибут может содержать кавычки (), знак меньше () или амперсанд< (&). Вызов метода закодирует атрибут в соответствии с требованиями запрашивающего устройства. Можно задать значение fEncodefalse, если известно, что ни один из этих символов не будет создан, или если вы знаете, что атрибут уже закодирован.

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

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

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

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

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

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

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

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