HtmlTextWriter.RenderBeginTag Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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
Aplica-se a
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 -> unitPublic 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 "Required"" myattribute="No "encoding" 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.