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
, а затем задает значениеfEncode
false
.Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод для закрытия
<img>
элемента.
В этом примере кода создается следующая разметка:
<img alt="AtlValue" myattribute="No "encoding" 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
, а затем задает значениеfEncode
false
.Закрывает открывающий тег элемента, а затем вызывает WriteEndTag метод для закрытия
<img>
элемента.
В этом примере кода создается следующая разметка:
<img alt="AtlValue" myattribute="No "encoding" 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) записать атрибут с пустым значением.