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 -> unitPublic 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 -> unitPublic 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) методу писать атрибут с пустым значением.
