ChtmlTextWriter.WriteBreak Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Escribe un br elemento en el flujo de salida de cHTML.

public:
 override void WriteBreak();

public override void WriteBreak();

override this.WriteBreak : unit -> unit

Public Overrides Sub WriteBreak ()

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo crear una clase cHTML y propiedades personalizadas. En el segundo ejemplo de código se muestra cómo usar una clase personalizada en una página web.

Para usar el adaptador personalizado ChtmlSimplelabelAdapter , agregue el código siguiente al archivo adecuado para todo el equipo en el subdirectorio para el explorador del directorio de configuración de .NET Framework o a un archivo de explorador personalizado en el directorio de App_Browsers en la raíz de la aplicación web.

<controlAdapters>
   <adapter controlType="AspNet.Samples.SimpleLabel"
   adapterType="AspNet.Samples.ChtmlSimpleLabelAdapter" />
</controlAdapters>

En el ejemplo de código siguiente se muestra cómo crear una clase de adaptador cHTML denominada ChtmlSimpleLabelAdapter para una clase denominada SimpleLabel. Crea una propiedad personalizada Control que permite que la ChtmlSimpleLabelAdapter clase acceda a los miembros de la SimpleLabel clase y, a continuación, invalida el Render método . En la invalidación, se producen las siguientes cosas:

• Crea una referencia a un ChtmlTextWriter objeto, denominado w, que se deriva del HtmlTextWriter objeto que se pasa como writer parámetro para el Render método .

• Crea una cadena y la establece igual al SimpleLabel.Text valor.

• Llama al EnterStyle método para aplicar los estilos definidos por la ControlStyle propiedad de la etiqueta al flujo de salida cHTML.

• Escribe el Text valor de propiedad en la secuencia y cierra el bloque de estilo llamando al ExitStyle método .

• Llama al WriteBreak método para representar un br elemento en el flujo de salida después de representar el texto y los estilos.

// Create a custom CHTML Adapter for a 
// SimpleLabel class.
public class ChtmlSimpleLabelAdapter : WebControlAdapter
{
    // Create the Control property to access
    // the properties and methods of the
    // SimpleLabel class.
    protected SimpleLabel Control
    {
        get
        {
            return (SimpleLabel)base.Control;
        }
    }

    // Override the Render method to render text
    // in CHTML with the style defined by the control
    // and a <br> element after the text and styles
    // have been written to the output stream. 
    protected override void Render(HtmlTextWriter writer)
    {
        ChtmlTextWriter w = new ChtmlTextWriter(writer);
        string value = Control.Text;

        // Render the text of the control using
        // the control's style settings.
        w.EnterStyle(Control.ControlStyle);
        w.Write(value);
        w.ExitStyle(Control.ControlStyle);
        w.WriteBreak();
    }
}

  ' Create a custom CHTML Adapter for a 
  ' class, named SimpleLabel.
  Public Class ChtmlSimpleLabelAdapter
       Inherits WebControlAdapter

    ' Create the Control property to access
    ' the properties and methods of the
    ' SimpleLabel class.
    Protected Shadows ReadOnly Property Control() As SimpleLabel
       Get
          Return CType(MyBase.Control, SimpleLabel)
       End Get
    End Property
 
 
    ' Override the Render method to render text
    ' in CHTML with the style defined by the control
    ' and a <br> element after the text and styles
    ' have been written to the output stream. 
      Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
          Dim w As ChtmlTextWriter = New ChtmlTextWriter(writer)
          Dim value As String = Control.Text

          ' Render the text of the control using
          ' the control's style settings.
          w.EnterStyle(Control.ControlStyle)
          w.Write(value)
          w.ExitStyle(Control.ControlStyle)
          w.WriteBreak()

      End Sub
End Class

En el ejemplo siguiente se muestra cómo usar la SimpleLabel clase en una página web.

<%@ Page Language="C#" %>
<%@ Import Namespace="AspNet.Samples" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    SimpleLabel sl = new SimpleLabel();
    sl.ID = "SimpleLabel1";
    sl.Text = "SimpleLabel Text";
    PlaceHolder1.Controls.Add(sl);

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CHtmlTextWriter Example</title>
</head>
<body>
    <form id="form1" runat="server" >
    <div>
      <asp:PlaceHolder ID="PlaceHolder1" runat="server"></asp:PlaceHolder>    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB"   %>
<%@ Import Namespace="AspNet.Samples" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim sl As SimpleLabel = New SimpleLabel()
    sl.ID = "SimpleLabel1"
    sl.Text = "SimpleLabel Text"
    PlaceHolder1.Controls.Add(sl)
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CHtmlTextWriter Example</title>
</head>
<body>
    <form id="form1" runat="server" >
    <div>
      <asp:PlaceHolder ID="PlaceHolder1" runat="server"></asp:PlaceHolder>    
    </div>
    </form>
</body>
</html>

Comentarios

Use el WriteBreak método para insertar un salto de línea en una secuencia de cHTML.

Consulte también

• WriteEncodedText(String)