Esporta (0) Stampa
Espandi tutto

Classe TextBox

Visualizza un controllo di casella di testo per l'input dell'utente.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[ValidationPropertyAttribute("Text")] 
[ControlValuePropertyAttribute("Text")] 
public class TextBox : WebControl, IPostBackDataHandler, IEditableTextControl, ITextControl
/** @attribute ValidationPropertyAttribute("Text") */ 
/** @attribute ControlValuePropertyAttribute("Text") */ 
public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl, 
	ITextControl
ValidationPropertyAttribute("Text") 
ControlValuePropertyAttribute("Text") 
public class TextBox extends WebControl implements IPostBackDataHandler, IEditableTextControl, 
	ITextControl

Il controllo server TextBox è un controllo di input che consente all'utente di inserire del testo. Per impostazione predefinita, la proprietà TextMode del controllo viene impostata sul valore TextBoxMode.SingleLine, che consente di visualizzare una casella a riga singola. Tuttavia, è possibile utilizzare il controllo TextBox anche per visualizzare una casella di testo a più righe che mascheri l'input dell'utente modificando il valore della proprietà TextMode rispettivamente su TextBoxMode.MultiLine o TextBoxMode.Password. Il testo visualizzato nel controllo TextBox viene specificato o determinato utilizzando la proprietà Text.

Il controllo TextBox contiene più proprietà che consentono di controllare l'aspetto del controllo. La larghezza di visualizzazione della casella di testo, in caratteri, viene determinata dalla relativa proprietà Columns. Se il controllo TextBox è una casella di testo a più righe, il numero di righe visualizzate viene determinato dalla proprietà Rows. Per visualizzare testo che ritorna a capo all'interno del controllo TextBox, impostare la proprietà Wrap su true.

È inoltre possibile specificare la modalità di immissione dei dati nel controllo TextBox impostando alcune proprietà. Per evitare che il testo visualizzato nel controllo subisca delle modifiche, impostare la proprietà ReadOnly su true. Se si desidera limitare l'input dell'utente a un numero specifico di caratteri, impostare la proprietà MaxLength.

Per un elenco dei valori iniziali della proprietà per un'istanza dell'oggetto TextBox, vedere il costruttore TextBox.

Nota di avvisoAttenzione

Questo controllo può essere utilizzato per accettare l'input dell'utente, che potrebbe includere uno script client non autorizzato. Verificare tutte le informazioni inviate da un client per uno script eseguibile, istruzioni SQL o altro codice, prima di visualizzarle nell'applicazione. È possibile utilizzare controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo immesso in un controllo. ASP.NET dispone di una funzionalità di convalida della richiesta di input per bloccare script e codice HTML nell'input dell'utente. Per ulteriori informazioni, vedere Protezione dei controlli standard, Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML e Convalida dell'input utente nelle pagine Web ASP.NET.

Accesso facilitato

Il codice sottoposto a rendering per impostazione predefinita per questo controllo potrebbe non essere conforme agli standard di accesso facilitato, come le linee guida WCAG (Web Content Accessibility Guidelines) 1.0 livello 1. Per informazioni dettagliate sul supporto dell'accesso facilitato per questo controllo, vedere Controlli ASP.NET e accesso facilitato.

ArgomentoPercorso
Procedura dettagliata: convalida dell'input dell'utente in una pagina Web FormGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: associazione ai dati a un oggetto business personalizzatoGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web di base in Visual Web DeveloperGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere alle modifiche in un controllo server Web TextBoxGenerazione di applicazioni Web ASP.NET
Procedura dettagliata: utilizzo di fogli di stili CSS in Visual Web DeveloperGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web DeveloperGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTMLGenerazione di applicazioni Web ASP.NET
Procedura: ottenere e impostare valori nei controlli server Web TextBoxGenerazione di applicazioni Web ASP.NET
Procedura: impostare le proprietà dei controlli server Web ASP.NETGenerazione di applicazioni Web ASP.NET
Procedura: specificare input multilinea per un controllo server Web TextBoxGenerazione di applicazioni Web ASP.NET
Procedura: impostare un controllo server Web TextBox per l'immissione di una passwordGenerazione di applicazioni Web ASP.NET
Procedura: impostare lo stato attivo sui controlli server Web ASP.NETGenerazione di applicazioni Web ASP.NET
Procedura: ottenere e impostare valori nei controlli server Web TextBoxCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere alle modifiche in un controllo server Web TextBoxCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: impostare le proprietà dei controlli server Web ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web DeveloperCompilazione di applicazioni con Visual Web Developer
Procedura: impostare un controllo server Web TextBox per l'immissione di una passwordCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: convalida dell'input dell'utente in una pagina Web FormCompilazione di applicazioni con Visual Web Developer
Procedura: impostare lo stato attivo sui controlli server Web ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: associazione ai dati a un oggetto business personalizzatoCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web di base in Visual Web DeveloperCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: specificare input multilinea per un controllo server Web TextBoxCompilazione di applicazioni Web ASP.NET in Visual Studio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il controllo TextBox per ottenere l'input dell'utente. Quando l'utente fa clic sul pulsante Aggiungi, viene visualizzata la somma dei valori immessi nelle caselle di testo.

<%@ Page Language="C#" AutoEventWireup="True" %>

<html> 

<head>

   <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 runat="server">

      <h3> TextBox Example </h3>

      <table>

         <tr>

            <td colspan="5">

               Enter integer values into the text boxes. <br>
               Click the Add button to add the two values. <br>
               Click the Reset button to reset the text boxes.

            </td>

         </tr>

         <tr>

            <td colspan="5">

               &nbsp;

            </td>

         </tr>

         <tr align="center">

            <td>

               <asp:TextBox ID="Value1"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               + 

            </td>

            <td>

               <asp:TextBox ID="Value2"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               =

            </td>

            <td>
               
               <asp:Label ID="AnswerMessage"
                    runat="server"/>

            </td>

         </tr>

         <tr>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value1RangeValidator"
                    ControlToValidate="Value1"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br>"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value2RangeValidator"
                    ControlToValidate="Value2"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br> between than 1 and 100.<br>"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td>

               &nbsp
 
            </td

         </tr>

         <tr align="center">

            <td colspan="4">

               <asp:Button ID="AddButton"
                    Text="Add"
                    OnClick="AddButton_Click"
                    runat="server"/>

            </td>

            <td>

               &nbsp;

            </td>

         </tr>

      </table>

   </form>

</body>
</html>

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft