Cenni preliminari sul controllo server Web TextBox

Articolo
10/22/2014

Aggiornamento: novembre 2007

Il controllo server Web TextBox consente agli utenti di immettere informazioni, inclusi testo, numeri e date, in una pagina Web ASP.NET.

Vengono illustrati i seguenti argomenti:

Informazioni di supporto
Esempi di codice
Riferimento alle classi

Informazioni di supporto

Il controllo server TextBox è un controllo di input che consente l'immissione di testo da parte dell'utente. Per impostazione predefinita, la proprietà TextMode del controllo viene impostata su TextBoxMode.SingleLine, che consente di visualizzare una casella di testo a riga singola. Tuttavia, è possibile impostare la proprietà TextMode su TextBoxMode.MultiLine per visualizzare una casella di testo a più righe, di cui viene eseguito il rendering come elemento textarea. È anche possibile modificare la proprietà TextMode in TextBoxMode.Password per visualizzare una casella di testo che mascheri l'input dell'utente. Il testo visualizzato nel controllo TextBox è disponibile utilizzando la proprietà Text.

Nota sulla sicurezza:
L'impostazione della proprietà TextMode su TextBoxMode.Password può contribuire ad assicurare che la password non venga vista da altri utenti al momento dell'immissione. Il testo immesso nella relativa casella non è tuttavia crittografato in alcun modo e deve essere protetto come ogni altra informazione riservata. Ad esempio, quando viene inviata una pagina contenente una password, è opportuno utilizzare SSL (Secure Sockets Layer) e le opzioni di crittografia per aumentarne il livello di sicurezza.

L'impostazione della proprietà TextMode su TextBoxMode.Password può contribuire ad assicurare che la password non venga vista da altri utenti al momento dell'immissione. Il testo immesso nella relativa casella non è tuttavia crittografato in alcun modo e deve essere protetto come ogni altra informazione riservata. Ad esempio, quando viene inviata una pagina contenente una password, è opportuno utilizzare SSL (Secure Sockets Layer) e le opzioni di crittografia per aumentarne il livello di sicurezza.

Nota sulla sicurezza:
L'input dell'utente in una pagina Web ASP.NET può includere script client potenzialmente dannoso. Per impostazione predefinita, la pagina Web ASP.NET verifica che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Eventi di TextBox

Il controllo TextBox genera un evento TextChanged non appena lo stato attivo viene passato a un altro controllo. Per impostazione predefinita, l'evento non viene generato immediatamente, ma si verifica sul server una volta inviata la pagina. È tuttavia possibile impostare TextBox in modo che invii la pagina al server non appena l'utente sposta lo stato attivo su un altro controllo.

Il controllo server Web TextBox non genera un evento ogni volta che viene premuto un tasto, ma solo quando l'utente sposta lo stato attivo su un altro controllo. È possibile configurare il controllo TextBox per la generazione di eventi sul lato client da gestire in script client. Questo può risultare utile per configurare le risposte alle singole pressioni dei tasti. Per informazioni, vedere Script client nelle pagine Web ASP.NET.

Didascalie di TextBox

Per creare didascalie relative ai controlli TextBox è possibile utilizzare dei controlli Label. La didascalia può definire un tasto di scelta che gli utenti possono premere per passare al controllo TextBox. Per informazioni dettagliate, vedere Procedura: utilizzare i controlli server Web Label come didascalie.

Completamento automatico nelle caselle di testo

Numerosi browser supportano una funzionalità di completamento automatico che consente agli utenti di inserire informazioni nelle caselle di testo sulla base di valori immessi in precedenza. L'esatto comportamento del completamento automatico dipende dal browser. In generale, i browser archiviano i valori sulla base dell'attributo name della casella di testo. In questo modo, in tutte le caselle di testo con lo stesso nome, anche se presenti in pagine differenti, vengono visualizzate automaticamente le stesse proposte di completamento. Alcuni browser supportano anche uno schema a vCard, che consente agli utenti di creare nel browser un profilo con valori predefiniti per il nome, il cognome, il numero di telefono, l'indirizzo di posta elettronica e così via.

Il controllo TextBox supporta una proprietà AutoCompleteType che fornisce le seguenti opzioni per il controllo del completamento automatico nel browser:

Disattivazione del completamento automatico. Se non si desidera che vengano visualizzate proposte di completamento automatico per una casella di testo, è possibile disattivare questa funzionalità.
Definizione di un valore vCard da utilizzare per il completamento automatico del campo. Il browser deve supportare lo schema vCard.