HtmlTextWriter.RenderBeginTag Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Grava a marca de abertura de um elemento de marcação no fluxo de saída.

Sobrecargas

RenderBeginTag(String)	Grava a marca de abertura do elemento de marcação especificado no fluxo de saída.
RenderBeginTag(HtmlTextWriterTag)	Grava a marca de abertura do elemento de marcação associado ao valor de enumeração HtmlTextWriterTag especificado no fluxo de saída.

RenderBeginTag(String)

Grava a marca de abertura do elemento de marcação especificado no fluxo de saída.

public:
 virtual void RenderBeginTag(System::String ^ tagName);

public virtual void RenderBeginTag (string tagName);

abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unit

Public Overridable Sub RenderBeginTag (tagName As String)

Parâmetros

tagName

String

Uma cadeia de caracteres que contém o nome do elemento de marcação para o qual a marca de abertura será renderizada.

Exemplos

O exemplo de código a seguir mostra como chamar o RenderBeginTag método em um controle personalizado para renderizar a marca de abertura de um elemento não padrão MyTag . O exemplo de código chama o Write método para renderizar a marcação interna e chama o RenderEndTag método para fechar o elemento.

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

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();

// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();

' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Comentários

Use a RenderBeginTag substituição do RenderBeginTag(String) método, se o elemento de marcação não for um dos valores de HtmlTextWriterTag enumeração.

Para gerar um elemento de marcação usando o RenderBeginTag método, primeiro chame os métodos e os AddAttribute AddStyleAttribute métodos, conforme necessário, para especificar quaisquer atributos de elemento ou atributos de estilo que devem aparecer na marca de abertura do elemento. Depois de gerar a marcação interna, chame o RenderEndTag método para gerar a marca de fechamento.

Confira também

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()

RenderBeginTag(HtmlTextWriterTag)

Grava a marca de abertura do elemento de marcação associado ao valor de enumeração HtmlTextWriterTag especificado no fluxo de saída.

public:
 virtual void RenderBeginTag(System::Web::UI::HtmlTextWriterTag tagKey);

public virtual void RenderBeginTag (System.Web.UI.HtmlTextWriterTag tagKey);

abstract member RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
override this.RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit

Public Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)

Parâmetros

tagKey

HtmlTextWriterTag

Um dos valores HtmlTextWriterTag que definem a marca de abertura do elemento de marcação a ser renderizado.

Exemplos

O exemplo de código a seguir mostra como usar o RenderBeginTag método para gerar a marca de abertura de um <img> elemento. Os atributos adicionados ao elemento pelo AddAttribute método estarão na marca de abertura <img> . O RenderEndTag método é usado para gerar a marca de fechamento.

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

<img alt="Encoding &quot;Required&quot;" myattribute="No &quot;encoding&quot; required">

</img>

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Comentários

Use a RenderBeginTag sobrecarga do RenderBeginTag(HtmlTextWriterTag) método se o elemento de marcação for de um tipo conhecido que seja um dos HtmlTextWriterTag valores de enumeração.

Para gerar um elemento de marcação usando o RenderBeginTag método, primeiro chame os métodos e os AddAttribute AddStyleAttribute métodos, conforme necessário, para especificar quaisquer atributos de elemento ou atributos de estilo que devem aparecer na marca de abertura do elemento. Depois de gerar a marcação interna, chame o RenderEndTag método para gerar a marca de fechamento.

Confira também

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()