HtmlTextWriter.WriteAttribute Метод

Определение

Записывает атрибут разметки и его значение в исходящий поток.

Перегрузки

WriteAttribute(String, String, Boolean)

Записывает указанные атрибут и значение разметки в поток вывода и, если указано, записывает закодированное значение.

WriteAttribute(String, String)

Записывает указанный атрибут и значение разметки в исходящий поток.

WriteAttribute(String, String, Boolean)

Записывает указанные атрибут и значение разметки в поток вывода и, если указано, записывает закодированное значение.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);
public virtual void WriteAttribute (string name, string value, bool fEncode);
abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit
Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

Параметры

name
String

Атрибут разметки для записи в поток вывода.

value
String

Значение, назначенное атрибуту.

fEncode
Boolean

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

Примеры

В следующем примере кода демонстрируется отрисовка <img> элемента, в котором вызываются обе перегрузки WriteAttribute метода . В примере кода используется следующий процесс:

  • WriteBeginTag Вызывает метод , который отрисовывает открывающие символы элемента.

  • Вызывает перегрузку WriteAttribute(String, String) , которая записывает alt атрибут и его значение в <img> элемент .

  • Вызывает перегрузку WriteAttribute(String, String, Boolean) для отрисовки настраиваемого myattribute атрибута со значением No "encoding" required, а затем задает значение fEncodefalse.

  • Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод для закрытия <img> элемента.

В этом примере кода создается следующая разметка:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );
// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Комментарии

Используйте метод для WriteAttribute записи атрибутов разметки и их значений с кодировкой или без нее. Метод WriteAttribute использует метод для HtmlAttributeEncode кодирования.

Метод WriteAttribute записывает значение атрибута, заключенное в двойные кавычки ("). Если value имеет значение null, WriteAttribute метод записывает только имя атрибута.

Примечания для тех, кто наследует этот метод

В производных классах метод можно переопределить WriteAttribute(String, String, Boolean) , чтобы определить настраиваемые правила для записи атрибутов и их значений. Например, можно написать код, который позволил методу WriteAttribute(String, String, Boolean) записать атрибут с пустым значением.

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

Применяется к

WriteAttribute(String, String)

Записывает указанный атрибут и значение разметки в исходящий поток.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);
public virtual void WriteAttribute (string name, string value);
abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit
Public Overridable Sub WriteAttribute (name As String, value As String)

Параметры

name
String

Атрибут, записываемый в исходящий поток.

value
String

Значение, назначенное атрибуту.

Примеры

В следующем примере кода демонстрируется отрисовка <img> элемента, в котором вызываются обе перегрузки WriteAttribute метода . В примере кода используется следующий процесс:

  • WriteBeginTag Вызывает метод , который отрисовывает открывающие символы элемента.

  • Вызывает перегрузку WriteAttribute(String, String) , которая записывает alt атрибут и его значение в <img> элемент .

  • Вызывает перегрузку WriteAttribute(String, String, Boolean) для отрисовки настраиваемого myattribute атрибута со значением No "encoding" required, а затем задает значение fEncodefalse.

  • Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод для закрытия <img> элемента.

В этом примере кода создается следующая разметка:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );
// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Комментарии

Используйте метод для WriteAttribute записи атрибутов разметки и их значений без кодировки. Метод WriteAttribute записывает значение атрибута, заключенное в двойные кавычки ("). Если value имеет значение null, WriteAttribute метод записывает только имя атрибута.

Примечания для тех, кто наследует этот метод

В производных классах метод можно переопределить WriteAttribute(String, String) , чтобы определить настраиваемые правила для записи атрибутов и их значений. Например, можно написать код, который позволил методу WriteAttribute(String, String) записать атрибут с пустым значением.

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

Применяется к