HtmlTextWriter.RenderBeginTag Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 -> unitPublic 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 "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()
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.