Partilhar via


HtmlTextWriter.WriteBeginTag(String) Método

Definição

Grava qualquer espaçamento de tabulação e a marca 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 gravar a marca de abertura.

Exemplos

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

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

  • Chama a WriteAttribute(String, String) sobrecarga, que grava um alt atributo e seu valor no <img> elemento .

  • Chama a WriteAttribute(String, String, Boolean) sobrecarga para renderizar um atributo personalizado myattribute , com um valor de No "encoding" requirede, em seguida, define fEncode como false.

  • Fecha a marca de abertura do elemento e 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)

Comentários

O WriteBeginTag método não grava o colchete angular de fechamento (>) da marca de abertura do elemento de marcação. Isso permite a gravação de atributos de marcação na marca de abertura do elemento. Use a TagRightChar constante para fechar a marca de abertura ao chamar o WriteBeginTag método . Use o WriteBeginTag método com a SelfClosingTagEnd constante ao gravar elementos de marcação que estão se auto-fechando.

O WriteBeginTag método é usado por controles de servidor personalizados que não permitem elementos de marcação ou mapeamento de atributo e renderizam elementos de marcação da mesma maneira para cada solicitação.

Aplica-se a

Confira também