Export (0) Print
Expand All

HtmlTextWriter.ExitStyle Method (Style)

Writes the closing tag of a <span> element to end the specified layout and character formatting.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public virtual void ExitStyle(
	Style style
)

Parameters

style
Type: System.Web.UI.WebControls.Style

A Style that specifies the layout and formatting to close.

The ExitStyle overload of the ExitStyle(Style) method renders the closing tag of a <span> element after the closing tag of the control, closing the element opened by the corresponding EnterStyle call.

The ExitStyle and EnterStyle methods allow a device adapter or control to create markup that begins and ends a block by using the character formatting of the specified style. Use the same value for style in the EnterStyle method that you use in the corresponding ExitStyle method.

The following code example demonstrates how to use a custom class named TextSample, derived from the WebControl class, that uses the EnterStyle method to apply a ForeColor style to a string of text.

The EnterStyle method renders the HTML <span style="color:Navy;">. The ExitStyle method call closes the <span> element after the text has been rendered.

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Drawing

' Create a custom class, named TextSample, that renders 
' its Text property with styles applied by the 
' EnterStyle and ExitStyle methods.  
Namespace AspNet.Samples

    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class TextSample
        Inherits Control

        ' Create an instance of the Style class. 
        Private textStyle As Style = New Style()
        Private textMessage As String 

        ' Create a Text property. 
        Public Property Text() As String 
            Get 
                Return textMessage
            End Get 
            Set(ByVal value As String)
                textMessage = value
            End Set 
        End Property 


        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
            ' Set the value of the Text property.
            textMessage = "Hello, World!" 

            ' Set the Style object's ForeColor 
            ' property to Navy.
            textStyle.ForeColor = Color.Navy

            ' Render the Text property with the style.
            writer.WriteLine("The text property styled: ")
            writer.EnterStyle(textStyle)
            writer.Write(Text)
            writer.ExitStyle(textStyle)

            ' Use the WriteBreak method twice to render 
            ' an empty line between the lines of rendered text.
            writer.WriteBreak()
            writer.WriteBreak()

            ' Render the Text property without the style.
            writer.WriteLine("The Text property unstyled: ")
            writer.Write(Text)
        End Sub 
    End Class 
End Namespace

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft