ChtmlTextWriter.WriteBreak Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Écrit un élément br dans le flux de sortie cHTML.

public:
 override void WriteBreak();

public override void WriteBreak ();

override this.WriteBreak : unit -> unit

Public Overrides Sub WriteBreak ()

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment créer une classe cHTML et des propriétés personnalisées. Le deuxième exemple de code montre comment utiliser une classe personnalisée sur une page Web.

Pour utiliser l’adaptateur personnalisé ChtmlSimplelabelAdapter , ajoutez le code suivant au fichier à l’échelle de l’ordinateur approprié dans le sous-répertoire du navigateur du répertoire de configuration .NET Framework ou à un fichier de navigateur personnalisé dans le répertoire App_Browsers sous la racine de l’application Web.

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

L’exemple de code suivant montre comment créer une classe d’adaptateur cHTML nommée ChtmlSimpleLabelAdapter pour une classe nommée SimpleLabel. Il crée une propriété personnalisée Control qui permet à la ChtmlSimpleLabelAdapter classe d’accéder aux membres de la SimpleLabel classe, puis remplace la Render méthode . Dans le remplacement, les choses suivantes se produisent :

• Il crée une référence à un ChtmlTextWriter objet, nommé w, qui est dérivé de l’objet HtmlTextWriter passé en tant que writer paramètre pour la Render méthode .

• Elle crée une chaîne et la définit comme égale à la SimpleLabel.Text valeur .

• Elle appelle la EnterStyle méthode pour appliquer les styles définis par la ControlStyle propriété de l’étiquette au flux de sortie cHTML.

• Il écrit la valeur de propriété Text dans le flux et ferme le bloc de style en appelant la ExitStyle méthode .

• Elle appelle la WriteBreak méthode pour afficher un br élément dans le flux de sortie après le rendu du texte et des styles.

// 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

L’exemple suivant montre comment utiliser la SimpleLabel classe dans une page 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>

Remarques

Utilisez la WriteBreak méthode pour insérer un saut de ligne dans un flux de cHTML.

Voir aussi

• WriteEncodedText(String)