TextBox Constructor

Definition

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

Applies to

See also