HtmlInputButton Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente l'accesso a livello di codice agli elementi HTML <input type= button>, <input type= submit>e <input type= reset> nel server.
public ref class HtmlInputButton : System::Web::UI::HtmlControls::HtmlInputControl, System::Web::UI::IPostBackEventHandler
public class HtmlInputButton : System.Web.UI.HtmlControls.HtmlInputControl, System.Web.UI.IPostBackEventHandler
type HtmlInputButton = class
inherit HtmlInputControl
interface IPostBackEventHandler
Public Class HtmlInputButton
Inherits HtmlInputControl
Implements IPostBackEventHandler
- Ereditarietà
- Derivato
- Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come usare il HtmlInputButton controllo per creare un pulsante di comando, un pulsante Invia e un pulsante Reimposta.
<%@ 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">
<script runat="server">
protected void SubmitButton_Click(object sender, EventArgs e)
{
Message.InnerText = "You entered: " + Server.HtmlEncode(Input1.Value);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlInputButton Example</title>
</head>
<body>
<form id="myform"
method="post"
enctype="application/x-www-form-urlencoded"
runat="server">
<div>
<input id="Input1"
type="Text"
maxlength="40"
runat="server"/>
<input id="SubmitButton"
type="submit"
value="Submit"
onserverclick="SubmitButton_Click"
runat="server" />
<input id="ResetButton"
type="reset"
value="Reset"
runat="server" />
<input id="Button"
type="button"
value="Button"
onclick="alert('Hello from the client side.');"
runat="server" />
<br />
<span id="Message"
runat="server"/>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Message.InnerText = "You entered: " + Server.HtmlEncode(Input1.Value)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>HtmlInputButton Example</title>
</head>
<body>
<form id="myform"
method="post"
enctype="application/x-www-form-urlencoded"
runat="server">
<div>
<input id="Input1"
type="Text"
maxlength="40"
runat="server"/>
<input id="SubmitButton"
type="submit"
value="Submit"
onserverclick="SubmitButton_Click"
runat="server" />
<input id="ResetButton"
type="reset"
value="Reset"
runat="server" />
<input id="Button"
type="button"
value="Button"
onclick="alert('Hello from the client side.');"
runat="server" />
<br />
<span id="Message"
runat="server"/>
</div>
</form>
</body>
</html>
Commenti
Usare la HtmlInputButton classe per creare controlli pulsante in una pagina Web. Un <input type=button> elemento HTML è un pulsante di scelta rapida senza alcun comportamento predefinito quando si fa clic. Un <input type=submit> elemento HTML è un pulsante che invia un modulo quando si fa clic su . Quando <input type=reset> si fa clic su un pulsante HTML, tutti i controlli vengono reimpostati sul valore iniziale.
In ASP.NET 2.0 usare rispettivamente la classe HtmlInputReset e la classe /HtmlInputSubmit per creare i pulsanti Reimposta e Invia.
Per un elenco dei valori iniziali delle proprietà per un'istanza di HtmlInputButton, vedere il costruttore HtmlInputButton.
Costruttori
| Nome | Descrizione |
|---|---|
| HtmlInputButton() |
Inizializza una nuova istanza della HtmlInputButton classe utilizzando i valori predefiniti. |
| HtmlInputButton(String) |
Inizializza una nuova istanza della HtmlInputButton classe utilizzando il tipo di pulsante specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Adapter |
Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control) |
| AppRelativeTemplateSourceDirectory |
Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control) |
| Attributes |
Ottiene una raccolta di tutte le coppie nome e valore dell'attributo espresse in un tag di controllo server all'interno della pagina ASP.NET. (Ereditato da HtmlControl) |
| BindingContainer |
Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control) |
| CausesValidation |
Ottiene o imposta un valore che indica se la convalida viene eseguita quando si fa clic sul HtmlInputButton controllo . |
| ChildControlsCreated |
Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control) |
| ClientID |
Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control) |
| ClientIDMode |
Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control) |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control) |
| 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 utilizzato in un'area di progettazione. (Ereditato da Control) |
| Disabled |
Ottiene o imposta un valore che indica se il controllo server HTML è disabilitato. (Ereditato da HtmlControl) |
| EnableTheming |
Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da Control) |
| EnableViewState |
Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control) |
| HasChildViewState |
Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| ID |
Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control) |
| IdSeparator |
Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control) |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control) |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control) |
| Name |
Ottiene o imposta il nome dell'identificatore univoco per il HtmlInputControl controllo. (Ereditato da HtmlInputControl) |
| 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 ID valore della proprietà. (Ereditato da Control) |
| Page |
Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control) |
| Parent |
Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control) |
| RenderingCompatibility |
Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control) |
| Site |
Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da Control) |
| Style |
Ottiene un insieme di tutte le proprietà CSS (Cascading Style Sheet) applicate a un controllo server HTML specificato nel file ASP.NET. (Ereditato da HtmlControl) |
| TagName |
Ottiene il nome dell'elemento di un tag che contiene un attributo e una |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| Type |
Ottiene il tipo di un oggetto HtmlInputControl. (Ereditato da HtmlInputControl) |
| UniqueID |
Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control) |
| ValidationGroup |
Ottiene o imposta il gruppo di controlli per cui determina la HtmlInputButton convalida quando esegue il postback al server. |
| Value |
Ottiene o imposta il valore associato al HtmlInputControl controllo . (Ereditato da HtmlInputControl) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se lo stato di HtmlControl visualizzazione fa distinzione tra maiuscole e minuscole. (Ereditato da HtmlControl) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control) |
Metodi
| Nome | Descrizione |
|---|---|
| AddedControl(Control, Int32) |
Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| AddParsedSubObject(Object) |
Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control) |
| ApplyStyleSheetSkin(Page) |
Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control) |
| BeginRenderTracing(TextWriter, Object) |
Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| BuildProfileTree(String, Boolean) |
Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella ClientID cache su |
| ClearChildControlState() |
Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildState() |
Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildViewState() |
Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearEffectiveClientIDMode() |
Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| CreateChildControls() |
Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da HtmlControl) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control) |
| Dispose() |
Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control) |
| EndRenderTracing(TextWriter, Object) |
Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| EnsureChildControls() |
Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato |
| FindControl(String) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato |
| Focus() |
Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control) |
| GetAttribute(String) |
Ottiene il valore dell'attributo denominato nel HtmlControl controllo . (Ereditato da HtmlControl) |
| GetDesignModeState() |
Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(String, Object) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control) |
| HasControls() |
Determina se il controllo server contiene controlli figlio. (Ereditato da Control) |
| HasEvents() |
Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control) |
| IsLiteralContent() |
Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control) |
| LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control) |
| LoadViewState(Object) |
Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente salvata dal SaveViewState() metodo . (Ereditato da Control) |
| MapPathSecure(String) |
Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnInit(EventArgs) |
Genera l'evento Init. (Ereditato da Control) |
| OnLoad(EventArgs) |
Genera l'evento Load. (Ereditato da Control) |
| OnPreRender(EventArgs) |
Genera l'evento OnPreRender(EventArgs) e registra lo script client per la generazione di postback. |
| OnServerClick(EventArgs) |
Genera l'evento ServerClick. In questo modo è possibile gestire direttamente l'evento. |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control) |
| RaisePostBackEvent(String) |
Genera eventi per il HtmlInputButton controllo quando esegue il postback al server. |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| Render(HtmlTextWriter) |
Scrive il contenuto di cui eseguire il rendering in un client nell'oggetto specificato HtmlTextWriter . (Ereditato da HtmlControl) |
| RenderAttributes(HtmlTextWriter) |
Esegue il rendering degli attributi nel writer specificato e quindi chiama il RenderAttributes(HtmlTextWriter) metodo . |
| RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag HTML di apertura del controllo nell'oggetto specificato HtmlTextWriter . (Ereditato da HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control) |
| ResolveAdapter() |
Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control) |
| ResolveClientUrl(String) |
Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control) |
| ResolveUrl(String) |
Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control) |
| SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione controllo server dopo il postback della pagina al server. (Ereditato da Control) |
| SetAttribute(String, String) |
Imposta il valore dell'attributo denominato nel HtmlControl controllo . (Ereditato da HtmlControl) |
| SetDesignModeState(IDictionary) |
Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| SetRenderMethodDelegate(RenderMethod) |
Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Determina il rilevamento delle modifiche dello stato di visualizzazione al controllo server in modo che possano essere archiviate nell'oggetto del StateBag controllo server. Questo oggetto è accessibile tramite la ViewState proprietà . (Ereditato da Control) |
Eventi
| Nome | Descrizione |
|---|---|
| DataBinding |
Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Disposed |
Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Init |
Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control) |
| Load |
Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control) |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control) |
| ServerClick |
Si verifica quando si fa clic su un HtmlInputButton controllo nella pagina Web. |
| Unload |
Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
Metodi di estensione
| Nome | Descrizione |
|---|---|
| FindDataSourceControl(Control) |
Restituisce l'origine dati associata al controllo dati per il controllo specificato. |
| FindFieldTemplate(Control, String) |
Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. |
| FindMetaTable(Control) |
Restituisce l'oggetto metatable per il controllo dati contenitore. |