TextBox Constructor
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the TextBox class.
public:
TextBox();
public TextBox ();
Public Sub New ()
Examples
The following code example demonstrates how to use the TextBox constructor to dynamically add a TextBox control to the page.
Important
This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> TextBox Constructor Example </title>
<script runat="server">
protected void Page_Load(Object sender, EventArgs e)
{
// Create UserTextBox TextBox control.
TextBox UserTextBox = new TextBox();
// Configure the UserTextBox TextBox control.
UserTextBox.ID = "UserTextBox";
UserTextBox.Columns = 50;
// Add UserTextBox TextBox control to the Controls collection
// of the TextBoxControlPlaceHolder PlaceHolder control.
TextBoxControlPlaceHolder.Controls.Add(UserTextBox);
}
protected void Submit_Click(Object sender, EventArgs e)
{
// Retrieve the UserTextBox TextBox control from the TextBoxControlPlaceHolder
// PlaceHolder control.
TextBox TempTextBox = (TextBox)TextBoxControlPlaceHolder.FindControl("UserTextBox");
// Display the Text property.
Message.Text = "The TextBox control above is dynamically generated. <br /> You entered: " +
TempTextBox.Text;
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> TextBox Constructor Example </h3>
Enter some text and click the Submit button. <br /><br />
<asp:PlaceHolder ID="TextBoxControlPlaceHolder"
runat="server"/>
<br /><br />
<asp:Button ID="SubmitButton"
Text="Submit"
OnClick="Submit_Click"
runat="server"/>
<br /><br />
<asp:Label ID="Message"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> TextBox Constructor Example </title>
<script runat="server">
Protected Sub Page_Load(sender As Object, e As EventArgs)
' Create UserTextBox TextBox control.
Dim UserTextBox As New TextBox()
' Configure the UserTextBox TextBox control.
UserTextBox.ID = "UserTextBox"
UserTextBox.Columns = 50
' Add UserTextBox TextBox control to the Controls collection
' of the TextBoxControlPlaceHolder PlaceHolder control.
TextBoxControlPlaceHolder.Controls.Add(UserTextBox)
End Sub
Protected Sub Submit_Click(sender As Object, e As EventArgs)
' Retrieve the UserTextBox TextBox control from the TextBoxControlPlaceHolder
' PlaceHolder control.
Dim TempTextBox As TextBox = CType(TextBoxControlPlaceHolder.FindControl("UserTextBox"), TextBox)
' Display the Text property.
Message.Text = "The TextBox control above is dynamically generated. <br /> You entered: " & _
TempTextBox.Text
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> TextBox Constructor Example </h3>
Enter some text and click the Submit button. <br /><br />
<asp:PlaceHolder ID="TextBoxControlPlaceHolder"
runat="server"/>
<br /><br />
<asp:Button ID="SubmitButton"
Text="Submit"
OnClick="Submit_Click"
runat="server"/>
<br /><br />
<asp:Label ID="Message"
runat="server"/>
</form>
</body>
</html>
Remarks
Use this constructor to create and initialize a new instance of the TextBox class.
The following table shows the initial property value for an instance of TextBox.
Property | Initial value |
---|---|
TagKey |
HtmlTextWriterTag.Input |