This documentation is archived and is not being maintained.

ITextControl Interface

Defines the interface a control implements to get or set its text content.

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

'Declaration
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Interface ITextControl
'Usage
Dim instance As ITextControl

The ITextControl interface defines the Text property a control implements to allow the getting or setting of its text content. The Text property can be set programmatically or through user input.

Caution noteCaution:

A control implementing this interface can be used to display user input. Before displaying user input, the input must be checked for malicious client script, such as executable script or SQL statements. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see Validation Server Control Syntax.

The following code example shows a custom control that implements the [T:System.Web.UI.]ITextControl interface. A default value is assigned to the Text property if Nothing is passed to the property.

Public Class CustomTextControl
    Inherits System.Web.UI.Control
    Implements System.Web.UI.ITextControl

    Private _text As String 

    Public Property Text() As String Implements System.Web.UI.ITextControl.Text
        Get 
            Return _text
        End Get 
        Set(ByVal value As String)
            If (value <> Nothing) Then
                _text = value
            Else
                _text = "No Value." 
            End If 
        End Set 
    End Property 

    ' Provide the remaining code to implement a text control. 
End Class

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: