ChtmlTextWriter.WriteBreak Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Schreibt ein br-Element in den cHTML-Ausgabestream.

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 Sie eine cHTML-Klasse und benutzerdefinierte Eigenschaften erstellen. Das zweite Codebeispiel veranschaulicht die Verwendung einer benutzerdefinierten Klasse auf einer Webseite.

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

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

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

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

• Es erstellt eine Zeichenfolge und legt ihn gleich dem SimpleLabel.Text Wert fest.

• Sie ruft die EnterStyle Methode auf, um die Formatvorlagen anzuwenden, die durch ControlStyle die Eigenschaft der Bezeichnung auf den CHTML-Ausgabestrom definiert sind.

• Er schreibt den Text Eigenschaftswert in den Datenstrom und schließt den Formatvorlagenblock, indem die Methode aufgerufen ExitStyle wird.

• Es ruft die WriteBreak Methode auf, um ein br Element nach dem Rendern des Text- und Formatvorlagens an den 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 veranschaulicht, wie Sie die SimpleLabel Klasse auf einer Webseite verwenden.

<%@ 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 CHTML-Datenstrom einzufügen.

Siehe auch

• WriteEncodedText(String)