HtmlTextWriter.WriteBeginTag(String) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Escreve qualquer espaçamento de tabulação e a etiqueta de abertura do elemento de marcação especificado no fluxo de saída.

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)

Parâmetros

tagName
String

O elemento de marcação do qual escrever a etiqueta de abertura.

Exemplos

O exemplo de código seguinte demonstra a renderização de um <img> elemento em que ambas as sobrecargas do WriteAttribute método são chamadas. O exemplo de código utiliza o seguinte processo:

  • Chama o WriteBeginTag método, que renderiza os caracteres iniciais do elemento.

  • Chama o WriteAttribute(String, String) overload, que escreve um alt atributo e o seu valor ao <img> elemento.

  • Chama o WriteAttribute(String, String, Boolean) overload para renderizar um atributo personalizado myattribute , com o valor de No "encoding" required, e depois define fEncode para false.

  • Fecha a etiqueta de abertura do elemento e depois chama o WriteEndTag método para fechar o <img> elemento.

Este exemplo de código gera a seguinte marcação:

<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)

Observações

O WriteBeginTag método não escreve o colchete angular de fecho (>) da etiqueta de abertura do elemento de marcação. Isto permite a escrita de atributos de marcação na etiqueta de abertura do elemento. Use a TagRightChar constante para fechar a etiqueta de abertura ao chamar o WriteBeginTag método. Use o WriteBeginTag método com a SelfClosingTagEnd constante quando escrever elementos de marcação que se auto-fecham.

O WriteBeginTag método é utilizado por controlos personalizados de servidor que não permitem o mapeamento de etiquetas ou atributos e não renderizam elementos de marcação da mesma forma para cada pedido.

Aplica-se a

Ver também