HtmlTextWriter.WriteAttribute Метод

Определение

Записывает атрибут разметки и его значение в исходящий поток.Writes a markup attribute and its value to the output stream.

Перегрузки

WriteAttribute(String, String, Boolean)

Записывает указанные атрибут и значение разметки в поток вывода и, если указано, записывает закодированное значение.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

WriteAttribute(String, String)

Записывает указанный атрибут и значение разметки в исходящий поток.Writes the specified markup attribute and value to the output stream.

WriteAttribute(String, String, Boolean)

Записывает указанные атрибут и значение разметки в поток вывода и, если указано, записывает закодированное значение.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

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

Атрибут разметки для записи в поток вывода.The markup attribute to write to the output stream.

value
String

Значение, назначенное атрибуту.The value assigned to the attribute.

fEncode
Boolean

Значение true для кодирования атрибута и назначенного значения; в противном случае — значение false.true to encode the attribute and its assigned value; otherwise, false.

Примеры

В следующем примере кода демонстрируется визуализация <img> элемента, в котором вызываются обе перегрузки WriteAttribute метода.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. В примере кода используется следующий процесс:The code example uses the following process:

  • WriteBeginTag Вызывает метод, который отображает открывающие символы элемента.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Вызывает перегрузку, которая alt записывает атрибут <img> и его значение в элемент. WriteAttribute(String, String)Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • false fEncode No "encoding" required myattribute Вызывает перегрузку для отображения пользовательского атрибута со значением, а затем задает для значение. WriteAttribute(String, String, Boolean)Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод, чтобы <img> закрыть элемент.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

Этот пример кода создает следующую разметку:This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Комментарии

WriteAttribute Используйте метод для записи атрибутов разметки и их значений с кодировкой или без нее.Use the WriteAttribute method to write markup attributes and their values with or without encoding. WriteAttribute МетодHtmlAttributeEncode использует метод для кодирования.The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

WriteAttribute Метод записывает значение атрибута, заключенное в двойные кавычки (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Если value имеет nullзначение ,WriteAttribute метод записывает только имя атрибута.If value is null, the WriteAttribute method writes only the attribute name.

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

В производных классах можно переопределить WriteAttribute(String, String, Boolean) метод, чтобы определить пользовательские правила для записи атрибутов и их значений.In derived classes, you can override the WriteAttribute(String, String, Boolean) method to define custom rules for writing attributes and their values. Например, можно написать код, который позволял WriteAttribute(String, String, Boolean) методу записывать атрибут с пустым значением.For example, you could write code that allowed the WriteAttribute(String, String, Boolean) method to write an attribute with an empty value.

Дополнительно

WriteAttribute(String, String)

Записывает указанный атрибут и значение разметки в исходящий поток.Writes the specified markup attribute and value to the output stream.

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

Атрибут, записываемый в исходящий поток.The attribute to write to the output stream.

value
String

Значение, назначенное атрибуту.The value assigned to the attribute.

Примеры

В следующем примере кода демонстрируется визуализация <img> элемента, в котором вызываются обе перегрузки WriteAttribute метода.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. В примере кода используется следующий процесс:The code example uses the following process:

  • WriteBeginTag Вызывает метод, который отображает открывающие символы элемента.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Вызывает перегрузку, которая alt записывает атрибут <img> и его значение в элемент. WriteAttribute(String, String)Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • false fEncode No "encoding" required myattribute Вызывает перегрузку для отображения пользовательского атрибута со значением, а затем задает для значение. WriteAttribute(String, String, Boolean)Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод, чтобы <img> закрыть элемент.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

Этот пример кода создает следующую разметку:This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Комментарии

WriteAttribute Используйте метод для записи атрибутов разметки и их значений без кодирования.Use the WriteAttribute method to write markup attributes and their values with no encoding. WriteAttribute Метод записывает значение атрибута, заключенное в двойные кавычки (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Если value имеет nullзначение ,WriteAttribute метод записывает только имя атрибута.If value is null, the WriteAttribute method writes only the attribute name.

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

В производных классах можно переопределить WriteAttribute(String, String) метод, чтобы определить пользовательские правила для записи атрибутов и их значений.In derived classes, you can override the WriteAttribute(String, String) method to define custom rules for writing attributes and their values. Например, можно написать код, который позволял WriteAttribute(String, String) методу записывать атрибут с пустым значением.For example, you could write code that allowed the WriteAttribute(String, String) method to write an attribute with an empty value.

Дополнительно

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