TextBox.Text TextBox.Text TextBox.Text TextBox.Text Property

Definição

Obtém ou define o conteúdo do texto do controle TextBox.Gets or sets the text content of the TextBox control.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.EncodedInnerDefaultProperty)]
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)]
public virtual string Text { get; set; }
member this.Text : string with get, set
Public Overridable Property Text As String

Valor da propriedade

O texto exibido no controle TextBox.The text displayed in the TextBox control. O padrão é uma cadeia de caracteres vazia ("").The default is an empty string ("").

Implementações

Exemplos

O exemplo de código a seguir demonstra como usar TextBox o controle para obter a entrada do usuário.The following code example demonstrates how to use the TextBox control to get user input. Quando o usuário clica no botão Adicionar , a soma dos valores inseridos nas caixas de texto é exibida.When the user clicks the Add button, the sum of the values entered in the text boxes is displayed.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.This example has a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.

<%@ Page Language="C#" AutoEventWireup="True" %>  
  
<!DOCTYPE html>  
<html>   
  
<head>  
    <title>TextBox Example</title>  
    <script runat="server">  
      protected void AddButton_Click(Object sender, EventArgs e)  
      {  
         int Answer;  
         Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);  
         AnswerMessage.Text = Answer.ToString();  
      }  
    </script>  
</head>  
<body>  
  <form id="form1" runat="server">  
    <h3> TextBox Example </h3>  
    <p>  
        <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        +  
        <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        =  
        <asp:Label ID="AnswerMessage" runat="server"/>  
    </p>  
    <p>  
        <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>  
    </p>  
    <p>  
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"  
             runat="server"/>  
        <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"      
             runat="server"/>  
    </p>  
  </form>  
</body>  
</html>  
<%@ Page Language="vb" AutoEventWireup="false" %>  
  
<!DOCTYPE html>  
<html>   
  
<head>  
    <title>TextBox Example</title>  
    <script runat="server">  
        Protected Sub AddButton_Click(sender As Object, e As EventArgs)  
            Dim Answer As Integer  
            Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)  
            AnswerMessage.Text = Answer.ToString()  
        End Sub  
    </script>  
</head>  
<body>  
  <form id="form1" runat="server">  
    <h3> TextBox Example </h3>  
    <p>  
        <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        +  
        <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>  
        =  
        <asp:Label ID="AnswerMessage" runat="server"/>  
    </p>  
    <p>  
        <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>  
    </p>  
    <p>  
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"  
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"  
             runat="server"/>  
        <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"  
             runat="server"/>  
        <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"  
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"  
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"      
             runat="server"/>  
    </p>  
  </form>  
</body>  
</html>  

Comentários

Use a Text propriedade para especificar ou determinar o texto exibido TextBox no controle.Use the Text property to specify or determine the text displayed in the TextBox control. Para limitar o número de caracteres aceitos pelo controle, defina a MaxLength propriedade.To limit the number of characters accepted by the control, set the MaxLength property. Se você quiser impedir que o texto seja modificado, defina a ReadOnly propriedade.If you want to prevent the text from being modified, set the ReadOnly property.

O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obter mais informações, LocalizableAttribute consulte e ASP.net globalização e localização.For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

Quando a caixa de texto é renderizada, o conteúdo dessa propriedade é codificado em HTML.When the text box is rendered, the contents of this property are HTML-encoded. Por exemplo, se você definir essa propriedade como "<b > test</b >", o navegador exibirá "<b > test</b >", não "teste" em negrito.For example, if you set this property to "<b>Test</b>", the browser will display "<b>Test</b>", not "Test" in bold.

Aplica-se a

Veja também