ChtmlTextWriter.WriteBreak Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Schreibt ein br Element in den cHTML-Ausgabedatenstrom.

public:
 override void WriteBreak();

public override void WriteBreak();

override this.WriteBreak : unit -> unit

Public Overrides Sub WriteBreak ()

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie eine cHTML-Klasse und benutzerdefinierte Eigenschaften erstellt werden. Das zweite Codebeispiel veranschaulicht die Verwendung einer benutzerdefinierten Klasse auf einer Webseite.

Um den benutzerdefinierten ChtmlSimplelabelAdapter Adapter zu verwenden, fügen Sie den folgenden Code entweder der entsprechenden computerweiten Datei im Unterverzeichnis für den Browser des .NET Framework-Konfigurationsverzeichnisses oder einer benutzerdefinierten Browserdatei im verzeichnis App_Browsers unter dem Stamm der Webanwendung hinzu.

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

Im folgenden Codebeispiel wird veranschaulicht, wie eine cHTML-Adapterklasse mit dem Namen einer Klasse mit dem Namen ChtmlSimpleLabelAdapterSimpleLabelerstellt wird. Sie erstellt eine benutzerdefinierte Control Eigenschaft, mit der die ChtmlSimpleLabelAdapter Klasse auf die Member der SimpleLabel Klasse zugreifen kann, und überschreibt dann die Render Methode. In der Außerkraftsetzung treten die folgenden Punkte auf:

• Er erstellt einen Verweis auf ein ChtmlTextWriter Objekt namens w, das vom HtmlTextWriter Objekt abgeleitet wird, das als writer Parameter für die Render Methode übergeben wird.

• Sie erstellt eine Zeichenfolge und legt sie auf den SimpleLabel.Text Wert fest.

• Sie ruft die EnterStyle Methode auf, um die Formatvorlagen anzuwenden, die durch die ControlStyle Eigenschaft der Bezeichnung auf den cHTML-Ausgabedatenstrom definiert werden.

• Er schreibt den Text Eigenschaftswert in den Datenstrom und schließt den Formatvorlagenblock durch Aufrufen der ExitStyle Methode.

• Sie ruft die WriteBreak Methode auf, um ein br Element nach dem Rendern von Text und Formatvorlagen im Ausgabedatenstrom zu rendern.

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

Im folgenden Beispiel wird die Verwendung der SimpleLabel Klasse auf einer Webseite veranschaulicht.

<%@ 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>

Hinweise

Verwenden Sie die WriteBreak Methode, um einen Zeilenumbruch in einen Datenstrom von cHTML einzufügen.

Weitere Informationen

• WriteEncodedText(String)