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

Definición

Obtiene o establece el contenido de texto del control 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 de propiedad

Texto mostrado en el control TextBox.The text displayed in the TextBox control. El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el TextBox control para obtener la entrada del usuario.The following code example demonstrates how to use the TextBox control to get user input. Cuando el usuario hace clic en el agregar se muestra el botón, la suma de los valores especificados en los cuadros de texto.When the user clicks the Add button, the sum of the values entered in the text boxes is displayed.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.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>  

Comentarios

Use la Text propiedad para especificar o determinar el texto mostrado en el TextBox control.Use the Text property to specify or determine the text displayed in the TextBox control. Para limitar el número de caracteres aceptado por el control, establezca el MaxLength propiedad.To limit the number of characters accepted by the control, set the MaxLength property. Si desea impedir que se modifique el texto, establezca el ReadOnly propiedad.If you want to prevent the text from being modified, set the ReadOnly property.

El valor de esta propiedad, cuando se establece, se pueden guardar automáticamente en un archivo de recursos utilizando una herramienta de diseñador.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obtener más información, consulte LocalizableAttribute y ASP.NET globalización y localización.For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

Cuando se representa el cuadro de texto, el contenido de esta propiedad está codificada en HTML.When the text box is rendered, the contents of this property are HTML-encoded. Por ejemplo, si establece esta propiedad en "<b > prueba</b >", el explorador mostrará"<b > prueba</b >", no "Test" en negrita.For example, if you set this property to "<b>Test</b>", the browser will display "<b>Test</b>", not "Test" in bold.

Se aplica a

Consulte también: