Comparteix a través de


HtmlTextWriter.RenderBeginTag Método

Definición

Escribe la etiqueta de apertura de un elemento de marcado en el flujo de salida.

Sobrecargas

RenderBeginTag(String)

Escribe la etiqueta de apertura del elemento de marcado especificado en el flujo de salida.

RenderBeginTag(HtmlTextWriterTag)

Escribe la etiqueta de apertura del elemento de marcado asociada al valor de la enumeración HtmlTextWriterTag especificado en el flujo de salida.

RenderBeginTag(String)

Escribe la etiqueta de apertura del elemento de marcado especificado en el flujo de salida.

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

Cadena que contiene el nombre del elemento de marcado para el que se va a representar la etiqueta de apertura.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al RenderBeginTag método en un control personalizado para representar la etiqueta de apertura de un elemento no estándar MyTag . A continuación, el ejemplo de código llama al Write método para representar el marcado interno y, a continuación, llama al RenderEndTag método para cerrar el elemento.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

Use la RenderBeginTag invalidación del RenderBeginTag(String) método si el elemento de marcado no es uno de los HtmlTextWriterTag valores de enumeración.

Para generar un elemento de marcado mediante el RenderBeginTag método , llame primero a los AddAttribute métodos y AddStyleAttribute , según sea necesario, para especificar cualquier atributo de elemento o atributo de estilo que aparezca en la etiqueta de apertura del elemento. Después de generar el marcado interno, llame al RenderEndTag método para generar la etiqueta de cierre.

Consulte también

Se aplica a

RenderBeginTag(HtmlTextWriterTag)

Escribe la etiqueta de apertura del elemento de marcado asociada al valor de la enumeración HtmlTextWriterTag especificado en el flujo de salida.

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

Uno de los valores de HtmlTextWriterTag que define la etiqueta de apertura del elemento de marcado que se va a representar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el RenderBeginTag método para generar la etiqueta de apertura de un <img> elemento. Los atributos agregados al elemento por el AddAttribute método estarán en la etiqueta de apertura <img> . El RenderEndTag método se usa para generar la etiqueta de cierre.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

Use la RenderBeginTag sobrecarga del RenderBeginTag(HtmlTextWriterTag) método si el elemento de marcado es de un tipo conocido que es uno de los HtmlTextWriterTag valores de enumeración.

Para generar un elemento de marcado mediante el RenderBeginTag método , llame primero a los AddAttribute métodos y AddStyleAttribute , según sea necesario, para especificar cualquier atributo de elemento o atributo de estilo que aparezca en la etiqueta de apertura del elemento. Después de generar el marcado interno, llame al RenderEndTag método para generar la etiqueta de cierre.

Consulte también

Se aplica a