HtmlTextWriter.WriteBeginTag(String) Метод

Определение

Записывает любой пробел табуляции и открывающий тег указанного элемента разметки в исходящий поток.Writes any tab spacing and the opening tag of the specified markup element to the output stream.

public:
 virtual void WriteBeginTag(System::String ^ tagName);
public virtual void WriteBeginTag (string tagName);
abstract member WriteBeginTag : string -> unit
override this.WriteBeginTag : string -> unit
Public Overridable Sub WriteBeginTag (tagName As String)

Параметры

tagName
String

Элемент разметки, открывающий тег которого предназначен для записи.The markup element of which to write the opening tag.

Примеры

В следующем примере кода демонстрируется визуализация <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)

Комментарии

WriteBeginTag Метод не записывает закрывающую угловую скобку (>) открывающего тега элемента разметки.The WriteBeginTag method does not write the closing angle bracket (>) of the markup element's opening tag. Это позволяет записывать атрибуты разметки в открывающий тег элемента.This allows the writing of markup attributes to the opening tag of the element. Используйте константу, чтобы закрыть открывающий тег при WriteBeginTag вызове метода. TagRightCharUse the TagRightChar constant to close the opening tag when calling the WriteBeginTag method. WriteBeginTag Используйте метод SelfClosingTagEnd с константой при написании закрывающих элементов разметки.Use the WriteBeginTag method with the SelfClosingTagEnd constant when you write markup elements that are self-closing.

WriteBeginTag Метод используется пользовательскими серверными элементами управления, которые не допускают сопоставление тегов или атрибутов и отображают элементы разметки таким же образом для каждого запроса.The WriteBeginTag method is used by custom server controls that do not allow tag or attribute mapping and render markup elements in the same way for each request.

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

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