Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.

Traduzione

Originale

Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe TextBox

.NET Framework 4.5

Altre versioni

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

Gerarchia di ereditarietà

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.TextBox

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

Sintassi

C++

[ControlValuePropertyAttribute("Text")]
[ValidationPropertyAttribute("Text")]
public class TextBox : WebControl, IPostBackDataHandler, 
	IEditableTextControl, ITextControl

ASP.NET

<asp:TextBox />

Il tipo TextBox espone i seguenti membri.

Costruttori

	Nome	Descrizione
	TextBox	Inizializza una nuova istanza di TextBox classe.

In alto

Proprietà

	Nome	Descrizione
	AccessKey	Ottiene o imposta il tasto di scelta che consente di spostarsi rapidamente al controllo server Web. (Ereditato da WebControl)
	Adapter	Ottiene l'adattatore browser-specifico per il controllo. (Ereditato da Control)
	AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all' applicazione dell' oggetto di UserControl o di Page contenente il controllo. (Ereditato da Control)
	Attributes	Ottiene la raccolta di attributi arbitrari (per eseguire il rendering solo) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
	AutoCompleteType	Ottiene o imposta un valore che indica il comportamento del completamento automatico di TextBox controllare
	AutoPostBack	Ottiene o imposta un valore che indica se un postback automatico al server si verifica quando TextBox il controllo perde lo stato attivo.
	BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
	BindingContainer	Infrastruttura. Ottiene il controllo contenente l'associazione dati del controllo. (Ereditato da Control)
	BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
	BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
	BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
	CausesValidation	Ottiene o imposta un valore che indica se la convalida viene eseguita quando TextBox il controllo è impostato per convalidare quando si verifica un postback.
	ChildControlsCreated	Ottiene un valore che indica se i controlli figlio del controllo server sono stati creati. (Ereditato da Control)
	ClientID	Ottiene l'ID del controllo per il markup HTML generato in ASP.NET. (Ereditato da Control)
	ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà di ClientID . (Ereditato da Control)
	ClientIDSeparator	Ottiene un valore del carattere che rappresenta il carattere separatore utilizzato nella proprietà di ClientID . (Ereditato da Control)
	Columns	Ottiene o imposta la larghezza di visualizzazione delle caselle di testo in caratteri.
	Context	Ottiene l'oggetto di HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
	Controls	Ottiene un oggetto di ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell' interfaccia utente. (Ereditato da Control)
	ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	ControlStyleCreated	ottiene un valore che indica se a Style l'oggetto è stato creato per ControlStyle proprietà. Questa proprietà viene utilizzata principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	CssClass	Ottiene o imposta la classe (CSS) del foglio di stile CSS eseguito il rendering con il controllo server Web nel client. (Ereditato da WebControl)
	DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
	DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
	DesignMode	Ottiene un valore che indica se un controllo viene utilizzata su un'area di progettazione. (Ereditato da Control)
	Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
	EnableTheming	Ottiene o imposta un valore che indica se i temi applicati al controllo. (Ereditato da WebControl)
	EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione dei controlli figlio che contiene, al client richiedente. (Ereditato da Control)
	Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control)
	Font	Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl)
	ForeColor	Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web. (Ereditato da WebControl)
	HasAttributes	Ottiene un valore che indica se il controllo contiene attributi impostati. (Ereditato da WebControl)
	HasChildViewState	Ottiene un valore che indica se i controlli figlio correnti del controllo server dispongono delle impostazioni salvate lo stato di visualizzazione. (Ereditato da Control)
	Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
	ID	Ottiene o imposta il ProgID assegnato al controllo server. (Ereditato da Control)
	IdSeparator	Infrastruttura. Ottiene il carattere utilizzato per separare gli identificatori del controllo. (Ereditato da Control)
	IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti nel controllo è stato del controllo. (Ereditato da Control)
	IsEnabled	Ottiene un valore che indica se il controllo è attivato. (Ereditato da WebControl)
	IsTrackingViewState	Ottiene un valore che indica se il controllo server sta salvando le modifiche nello stato di visualizzazione. (Ereditato da Control)
	IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per il controllo. (Ereditato da Control)
	LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione da ID invece dell' indice. (Ereditato da Control)
	MaxLength	Ottiene o imposta il numero massimo di caratteri consentito nella casella di testo.
	NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso valore della proprietà di Control.ID . (Ereditato da Control)
	Page	Ottiene un riferimento all' istanza di Page che contiene il controllo server. (Ereditato da Control)
	Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
	ReadOnly	Ottiene o imposta un valore che indica se il contenuto TextBox il controllo può essere modificato.
	RenderingCompatibility	Ottiene un valore che specifica la versione di ASP.NET che il codice HTML di cui è stato eseguito il rendering verrà compatibile con. (Ereditato da Control)
	Rows	Ottiene o imposta il numero di righe visualizzate in una casella di testo su più righe.
	Site	Ottiene le informazioni sul contenitore che ospita il controllo corrente una volta eseguito il rendering in un'area di progettazione. (Ereditato da Control)
	SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl)
	Style	Ottiene una raccolta di attributi di testo che verranno sottoposti a rendering come attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
	SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare disabled l'attributo dell'elemento HTML di cui è stato eseguito il rendering su “disattivare„ quando il controllo IsEnabled la proprietà è false. (Ereditato da WebControl)
	TabIndex	Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl)
	TagKey	ottiene il tag HTML per il controllo casella di testo. questa proprietà è protetta. (Esegue l'override di WebControl.TagKey).
	TagName	Ottiene il nome del tag del controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	TemplateControl	Ottiene o imposta un riferimento al modello contenente il controllo. (Ereditato da Control)
	TemplateSourceDirectory	Ottiene la directory virtuale di Page o di UserControl che contiene il controllo server corrente. (Ereditato da Control)
	Text	Ottiene o imposta il contenuto di testo di TextBox controllare.
	TextMode	Ottiene o imposta la modalità di comportamento (a riga singola, su più righe, password o) di TextBox controllare.
	ToolTip	Ottiene o imposta il testo da visualizzare quando il puntatore del mouse viene posizionato su un controllo server Web. (Ereditato da WebControl)
	UniqueID	Ottiene l'identificatore univoco e gerarchico completo per il controllo server. (Ereditato da Control)
	ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verificare l'input del client dal browser per i valori potenzialmente non sicuri. (Ereditato da Control)
	ValidationGroup	Ottiene o imposta il gruppo di controlli per cui TextBox il controllo genera la convalida durante l'inserimento di nuovo al server.
	ViewState	Ottiene un dizionario di informazioni sullo stato che consentono di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste della stessa pagina. (Ereditato da Control)
	ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto di StateBag prevede la distinzione tra maiuscole e minuscole. (Ereditato da Control)
	ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione del controllo. (Ereditato da Control)
	Visible	Ottiene o imposta un valore che indica se un controllo server viene eseguito il rendering come interfaccia utente nella pagina. (Ereditato da Control)
	Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)
	Wrap	Ottiene o imposta un valore che indica se il wrapping del contenuto di testo all'interno di una casella di testo su più righe.

In alto

Metodi

	Nome	Descrizione
	AddAttributesToRender	Infrastruttura. Aggiunge gli attributi HTML e stili che devono essere eseguito il rendering in specificati HtmlTextWriter istanza. (Esegue l'override di WebControl.AddAttributesToRender(HtmlTextWriter)).
	AddedControl	Chiamato dopo che un controllo figlio aggiunto alla raccolta di Controls dell' oggetto di Control . (Ereditato da Control)
	AddParsedSubObject	Infrastruttura. Eseguito l'override di per consentire solo i controlli letterali da aggiungere come Text proprietà. (Esegue l'override di Control.AddParsedSubObject(Object)).
	ApplyStyle	Copia tutti gli elementi di nonblank dello stile specificato al controllo Web, sovrascrivendo gli elementi di stile esistenti del controllo. Questo metodo è principalmente utilizzato dagli sviluppatori del controllo. (Ereditato da WebControl)
	ApplyStyleSheetSkin	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo. (Ereditato da Control)
	BeginRenderTracing	Avviare l'analisi in fase di progettazione dei dati di rendering. (Ereditato da Control)
	BuildProfileTree	Infrastruttura. Raccoglie informazioni sul controllo server e la consegna alla proprietà di Trace da visualizzare quando è abilitata la tracciatura per la pagina. (Ereditato da Control)
	ClearCachedClientID	Infrastruttura. Imposta il valore memorizzato nella cache di ClientID a null. (Ereditato da Control)
	ClearChildControlState	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
	ClearChildState	Elimina lo stato di visualizzazione e le informazioni sullo stato del controllo per i controlli figlio di un controllo server. (Ereditato da Control)
	ClearChildViewState	Elimina le informazioni sullo stato di visualizzazione per i controlli figlio di un controllo server. (Ereditato da Control)
	ClearEffectiveClientIDMode	Infrastruttura. Impostare la proprietà di ClientIDMode dell' istanza del controllo corrente e di tutti i controlli figlio di Inherit. (Ereditato da Control)
	CopyBaseAttributes	Copia le proprietà non incapsulate da Style oggetto dal controllo server Web specificato al controllo server Web che questo metodo viene chiamato da. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	CreateChildControls	Chiamato dal framework di pagine ASP.NET per notificare ai controlli server che utilizzano all' implementazione basata su composizione per creare i controlli figlio possono contenere in preparazione di eseguire il postback o di eseguire il rendering. (Ereditato da Control)
	CreateControlCollection	Crea un nuovo oggetto di ControlCollection per utilizzare i controlli figlio (sia valore letterale di server) del controllo server. (Ereditato da Control)
	CreateControlStyle	Crea l'oggetto stile utilizzato internamente da WebControl classe per implementare tutte le proprietà correlate di stile. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	DataBind()	Associare un'origine dati al controllo server richiamato e tutti i relativi controlli figlio. (Ereditato da Control)
	DataBind(Boolean)	Associare un'origine dati al controllo server richiamato e tutti i relativi controlli figlio con un'opzione generare l'evento di DataBinding . (Ereditato da Control)
	DataBindChildren	Associare un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
	Dispose	Consente a un controllo server per eseguire un'operazione finale puliscono prima che venga rilasciato dalla memoria. (Ereditato da Control)
	EndRenderTracing	Termina la tracciatura in fase di progettazione dei dati di rendering. (Ereditato da Control)
	EnsureChildControls	Determina se il controllo server contiene i controlli figlio. In caso contrario, crea i controlli figlio. (Ereditato da Control)
	EnsureID	Crea un identificatore per i controlli che non dispongono di un identificatore assegnato. (Ereditato da Control)
	Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
	FindControl(String)	Cercare il contenitore di denominazione corrente un controllo server con il parametro specificato di id . (Ereditato da Control)
	FindControl(String, Int32)	Infrastruttura. Cercare il contenitore di denominazione corrente un controllo server con id specificato e un Integer, specificato nel parametro di pathOffset , che supporta la ricerca. Non è necessario eseguire l'override di questa versione del metodo di FindControl . (Ereditato da Control)
	Focus	Imposta lo stato attivo per l'input in un controllo. (Ereditato da Control)
	GetDesignModeState	Infrastruttura. Ottiene i dati in fase di progettazione per un controllo. (Ereditato da Control)
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetRouteUrl(Object)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
	GetRouteUrl(RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
	GetRouteUrl(String, Object)	Ottiene l'URL corrispondente a un set di parametri di route e del nome della route. (Ereditato da Control)
	GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route e del nome della route. (Ereditato da Control)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	GetUniqueIDRelativeTo	Restituisce la parte con prefisso della proprietà di UniqueID del controllo specificato. (Ereditato da Control)
	HasControls	Determina se il controllo server contiene i controlli figlio. (Ereditato da Control)
	HasEvents	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o i controlli figlio. (Ereditato da Control)
	IsLiteralContent	Infrastruttura. Determina se il controllo server utilizza solo il contenuto letterale. (Ereditato da Control)
	LoadControlState	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente in cui è stata salvata tramite il metodo di SaveControlState . (Ereditato da Control)
	LoadPostData	elabora i dati di postback per TextBox controllare.
	LoadViewState	Ripristina le informazioni sullo stato di visualizzazione da una richiesta precedente in cui è stata salvata con SaveViewState metodo. (Ereditato da WebControl)
	MapPathSecure	Recupera il percorso fisico di un percorso virtuale, assoluto o relativo, mapping. (Ereditato da Control)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	MergeStyle	Copia tutti gli elementi di nonblank dello stile specificato al controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	OnBubbleEvent	Determina se l'evento del controllo server viene passata nella gerarchia dei controlli server dell' interfaccia utente della pagina. (Ereditato da Control)
	OnDataBinding	Genera l'evento di DataBinding . (Ereditato da Control)
	OnInit	Genera l'evento di Init . (Ereditato da Control)
	OnLoad	Genera l'evento di Load . (Ereditato da Control)
	OnPreRender	Infrastruttura. Registra lo script client per la generazione di eventi postback prima del rendering sul client, se AutoPostBack viene true. (Esegue l'override di Control.OnPreRender(EventArgs)).
	OnTextChanged	Generato TextChanged evento. Ciò consente di gestire direttamente l'evento.
	OnUnload	Genera l'evento di Unload . (Ereditato da Control)
	OpenFile	Ottiene Stream utilizzato per leggere un file. (Ereditato da Control)
	RaiseBubbleEvent	Assegna tutti i database di origine evento e delle relative informazioni al controllo padre. (Ereditato da Control)
	RaisePostDataChangedEvent	richiama OnTextChanged metodo quando i dati inviati per TextBox il controllo è stato modificato.
	RemovedControl	Chiamato dopo che un controllo figlio viene rimosso dalla raccolta di Controls dell' oggetto di Control . (Ereditato da Control)
	Render	esegue il rendering TextBox controllare nel parametro specificato HtmlTextWriter oggetto. (Esegue l'override di WebControl.Render(HtmlTextWriter)).
	RenderBeginTag	Esegue il rendering del tag HTML di apertura del controllo sul writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	RenderChildren	Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto fornito di HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering sul client. (Ereditato da Control)
	RenderContents	Esegue il rendering del contenuto del controllo sul writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	RenderControl(HtmlTextWriter)	Contenuto del controllo server di output a un oggetto di HtmlTextWriter e alle informazioni di traccia forniti dei file sul controllo se è attivata. (Ereditato da Control)
	RenderControl(HtmlTextWriter, ControlAdapter)	Contenuto del controllo server di output a un oggetto fornito di HtmlTextWriter utilizzando un oggetto specificato di ControlAdapter . (Ereditato da Control)
	RenderEndTag	Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori del controllo. (Ereditato da WebControl)
	ResolveAdapter	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
	ResolveClientUrl	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
	ResolveUrl	Converte un URL in uno che è utilizzabile nel client richiedente. (Ereditato da Control)
	SaveControlState	Salvare tutti i cambiamenti di stato del controllo server che si sono verificati sul tempo che la pagina è stata rinviata al server. (Ereditato da Control)
	SaveViewState	Salva le modifiche nello stato di visualizzazione della casella di testo sul tempo che la pagina è stata rinviata al server. (Esegue l'override di WebControl.SaveViewState()).
	SetDesignModeState	Imposta i dati in fase di progettazione per un controllo. (Ereditato da Control)
	SetRenderMethodDelegate	Infrastruttura. Assegna un delegato del gestore eventi per il rendering del controllo server e il relativo contenuto nel controllo padre. (Ereditato da Control)
	SetTraceData(Object, Object)	Imposta i dati di traccia per l'analisi in fase di progettazione dei dati di rendering, utilizzando la chiave di dati di analisi e il valore dei dati di traccia. (Ereditato da Control)
	SetTraceData(Object, Object, Object)	Imposta i dati di traccia per l'analisi in fase di progettazione dei dati di rendering, utilizzando l'oggetto rintracciato, la chiave di dati di analisi e il valore dei dati di traccia. (Ereditato da Control)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
	TrackViewState	Genera il controllo per tenere traccia delle modifiche nello stato di visualizzazione in modo da poter essere archiviate nell'oggetto ViewState proprietà. (Ereditato da WebControl)

In alto

Eventi

	Nome	Descrizione
	DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
	Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, che è l'ultima fase del ciclo di vita del controllo server in cui viene richiesta una pagina ASP.NET. (Ereditato da Control)
	Init	Si verifica quando il controllo server viene inizializzato, che è la prima fase del ciclo di vita. (Ereditato da Control)
	Load	Si verifica quando il controllo server viene caricato nell' oggetto di Page . (Ereditato da Control)
	PreRender	Si verifica dopo che l'oggetto di Control viene caricato ma prima del rendering. (Ereditato da Control)
	TextChanged	Si verifica quando il contenuto della casella di testo tra il postback al server.
	Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

In alto

Metodi di estensione

	Nome	Descrizione
	FindDataSourceControl	Restituisce l'origine dati associata al controllo dati per il controllo specificato. (Definito da DynamicDataExtensions).
	FindFieldTemplate	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. (Definito da DynamicDataExtensions).
	FindMetaTable	Restituisce l'oggetto metatable del controllo dati contenitore. (Definito da DynamicDataExtensions).

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IAttributeAccessor.GetAttribute	Infrastruttura. Ottiene un attributo di controlli Web con il nome specificato. (Ereditato da WebControl)
	IAttributeAccessor.SetAttribute	Imposta un attributo di controlli Web al nome e il valore specificato. (Ereditato da WebControl)
	IControlBuilderAccessor.ControlBuilder	Per una descrizione del membro, vedere IControlBuilderAccessor.ControlBuilder. (Ereditato da Control)
	IControlDesignerAccessor.GetDesignModeState	Per una descrizione del membro, vedere IControlDesignerAccessor.GetDesignModeState. (Ereditato da Control)
	IControlDesignerAccessor.SetDesignModeState	Per una descrizione del membro, vedere IControlDesignerAccessor.SetDesignModeState. (Ereditato da Control)
	IControlDesignerAccessor.SetOwnerControl	Infrastruttura. Per una descrizione del membro, vedere IControlDesignerAccessor.SetOwnerControl. (Ereditato da Control)
	IControlDesignerAccessor.UserData	Per una descrizione del membro, vedere IControlDesignerAccessor.UserData. (Ereditato da Control)
	IDataBindingsAccessor.DataBindings	Per una descrizione del membro, vedere IDataBindingsAccessor.DataBindings. (Ereditato da Control)
	IDataBindingsAccessor.HasDataBindings	Per una descrizione del membro, vedere IDataBindingsAccessor.HasDataBindings. (Ereditato da Control)
	IExpressionsAccessor.Expressions	Per una descrizione del membro, vedere IExpressionsAccessor.Expressions. (Ereditato da Control)
	IExpressionsAccessor.HasExpressions	Per una descrizione del membro, vedere IExpressionsAccessor.HasExpressions. (Ereditato da Control)
	IParserAccessor.AddParsedSubObject	Per una descrizione del membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
	IPostBackDataHandler.LoadPostData	Infrastruttura. Carica il contenuto inserito nella casella di testo se è diversa dall'ultimo invio.
	IPostBackDataHandler.RaisePostDataChangedEvent	Infrastruttura. richiama OnTextChanged metodo quando i dati immessi dalla casella di testo sono stati modificati.

In alto

Note

in questo argomento:

introduzione
sintassi dichiarativa

introduzione

TextBox il controllo server web è un controllo di input che consente all'utente di immettere testo. per impostazione predefinita, TextMode la proprietà del controllo è impostata su TextBoxMode.SingleLine, che visualizza una casella di testo a riga singola. Tuttavia, è anche possibile utilizzare TextBox controllare per visualizzare una casella di testo su più righe o una casella di testo di maschera di input utente modifica il valore di TextMode proprietà di TextBoxMode.MultiLine o TextBoxMode.Password, rispettivamente. Il testo visualizzato in TextBox il controllo viene specificato o determinato tramite Text proprietà.

TextBox il controllo contiene numerose proprietà che consentono di controllare l'aspetto del controllo. La larghezza di visualizzazione delle caselle di testo, i caratteri, è determinata dal Columns proprietà. se TextBox il controllo è una casella di testo a più righe, il numero di righe da visualizzare è determinata da Rows proprietà. Per visualizzare testo che esegue il wrapping nel TextBox controllare, impostare Wrap proprietà di true.

È inoltre possibile specificare come i dati vengono immessi in TextBox verificare impostando alcune proprietà. Per impedire il testo visualizzato nel controllo venga modificata, impostare ReadOnly proprietà di true. Se si desidera limitare l'input utente a un numero specificato di caratteri, impostare MaxLength proprietà.

Per un elenco di valori di proprietà iniziali per un'istanza di TextBox, vedere TextBox costruttore.

Attenzione
Questo controllo può essere utilizzato per accettare l'input utente, che può includere script client malintenzionato. Controllare ogni informazione inviata da un client per lo script eseguibile, le istruzioni SQL, o altro codice prima della visualizzazione dell'applicazione. È possibile utilizzare i controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo di input in un controllo. In ASP.NET è disponibile una funzionalità di convalida delle richieste di input allo script di blocco e HTML nell'input dell'utente. Per ulteriori informazioni, vedere Proteggere i controlli standard, Procedura: Protezione dagli attacchi tramite script in un'applicazione Web applicando la codifica HTML alle stringhee Introduzione a convalidare l'input utente nelle pagine Web ASP.NET.

Attenzione

Questo controllo può essere utilizzato per accettare l'input utente, che può includere script client malintenzionato. Controllare ogni informazione inviata da un client per lo script eseguibile, le istruzioni SQL, o altro codice prima della visualizzazione dell'applicazione. È possibile utilizzare i controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo di input in un controllo. In ASP.NET è disponibile una funzionalità di convalida delle richieste di input allo script di blocco e HTML nell'input dell'utente. Per ulteriori informazioni, vedere Proteggere i controlli standard, Procedura: Protezione dagli attacchi tramite script in un'applicazione Web applicando la codifica HTML alle stringhee Introduzione a convalidare l'input utente nelle pagine Web ASP.NET.

sintassi dichiarativa

<asp:TextBox
    AccessKey="string"
    AutoCompleteType="None|Disabled|Cellular|Company|Department|
        DisplayName|Email|FirstName|Gender|HomeCity|HomeCountryRegion|
        HomeFax|HomePhone|HomeState|HomeStreetAddress|HomeZipCode|
        Homepage|JobTitle|LastName|MiddleName|Notes|Office|Pager|
        BusinessCity|BusinessCountryRegion|BusinessFax|BusinessPhone|
        BusinessState|BusinessStreetAddress|BusinessUrl|
        BusinessZipCode|Search"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Columns="integer"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    MaxLength="integer"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    ReadOnly="True|False"
    Rows="integer"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextMode="SingleLine|MultiLine|Password"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
    Wrap="True|False"
/>

Topic	Location
Procedura dettagliata: convalida dell'input dell'utente in una pagina Web Form	Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: associazione ai dati a un oggetto business personalizzato	Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web di base in Visual Web Developer	Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere alle modifiche in un controllo server Web TextBox	Generazione di applicazioni Web ASP.NET
Procedura dettagliata: utilizzo di fogli di stili CSS in Visual Web Developer	Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web Developer	Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML	Generazione di applicazioni Web ASP.NET
Procedura: ottenere e impostare valori nei controlli server Web TextBox	Generazione di applicazioni Web ASP.NET
Procedura: impostare le proprietà dei controlli server Web ASP.NET	Generazione di applicazioni Web ASP.NET
Procedura: specificare input multilinea per un controllo server Web TextBox	Generazione di applicazioni Web ASP.NET
Procedura: impostare un controllo server Web TextBox per l'immissione di una password	Generazione di applicazioni Web ASP.NET
Procedura: impostare lo stato attivo sui controlli server Web ASP.NET	Generazione di applicazioni Web ASP.NET
Procedura: ottenere e impostare valori nei controlli server Web TextBox	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere alle modifiche in un controllo server Web TextBox	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: impostare le proprietà dei controlli server Web ASP.NET	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web Developer	Compilazione di applicazioni con Visual Web Developer
Procedura: impostare un controllo server Web TextBox per l'immissione di una password	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: convalida dell'input dell'utente in una pagina Web Form	Compilazione di applicazioni con Visual Web Developer
Procedura: impostare lo stato attivo sui controlli server Web ASP.NET	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: associazione ai dati a un oggetto business personalizzato	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web di base in Visual Web Developer	Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: specificare input multilinea per un controllo server Web TextBox	Compilazione di applicazioni Web ASP.NET in Visual Studio

Esempi

Un progetto di sito Web di Visual Studio con codice sorgente relativo a complemento di questo argomento: download.

Nell'esempio di codice seguente viene illustrato come utilizzare TextBox controllare per ottenere l'input dell'utente. Quando l'utente fa clic su aggiungere button, la somma dei valori immessi nelle caselle di testo visualizzato.

Nota sulla sicurezza
In questo esempio è inclusa una casella di testo che accetta l'input dell'utente, rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.


<%@ 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 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>

      <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>

Informazioni sulla versione

.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Piattaforme

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI.WebControls

Altre risorse

TextBox Web Server Control Overview

Script Exploits Overview

Il documento è risultato utile? Sì No

Non accurato

Incompleto

Ulteriori esempi di codice

La traduzione deve essere migliorata

(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?

Informativa sulla privacy