ChtmlTextWriter.WriteBreak Methode

Definitie

Hiermee schrijft u een br element naar de cHTML-uitvoerstroom.

public:
 override void WriteBreak();
public override void WriteBreak();
override this.WriteBreak : unit -> unit
Public Overrides Sub WriteBreak ()

Voorbeelden

Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u een cHTML-klasse en aangepaste eigenschappen maakt. In het tweede codevoorbeeld ziet u hoe u een aangepaste klasse op een webpagina gebruikt.

Als u de aangepaste ChtmlSimplelabelAdapter-adapter wilt gebruiken, voegt u de volgende code toe aan het juiste computerbrede bestand in de submap voor de browser van de .NET Framework-configuratiemap of aan een aangepast browserbestand in de App_Browsers map onder de hoofdmap van de webtoepassing.

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

In het volgende codevoorbeeld ziet u hoe u een cHTML-adapterklasse maakt met de naam ChtmlSimpleLabelAdapterSimpleLabelvan een klasse. Er wordt een aangepaste Control eigenschap gemaakt waarmee de ChtmlSimpleLabelAdapter klasse toegang heeft tot de leden van de SimpleLabel klasse en vervolgens de Render methode overschrijft. In de onderdrukking vinden de volgende dingen plaats:

  • Er wordt een verwijzing gemaakt naar een ChtmlTextWriter object met de naam w, dat is afgeleid van het HtmlTextWriter object dat wordt doorgegeven als de writer parameter voor de Render methode.

  • Er wordt een tekenreeks gemaakt en ingesteld op de SimpleLabel.Text waarde.

  • Hiermee wordt de EnterStyle methode aangeroepen om de stijlen toe te passen die zijn gedefinieerd door de ControlStyle eigenschap van het label op de cHTML-uitvoerstroom.

  • De eigenschapswaarde Text wordt naar de stream geschreven en het stijlblok gesloten door de methode aan te ExitStyle roepen.

  • De methode wordt aangeroepen WriteBreak om een br element weer te geven aan de uitvoerstroom nadat de tekst en stijlen zijn weergegeven.

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

In het volgende voorbeeld ziet u hoe u de SimpleLabel klasse op een webpagina gebruikt.

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

Opmerkingen

Gebruik de WriteBreak methode om een regeleinde in te voegen in een stroom cHTML.

Van toepassing op

Zie ook