LE WEBFORM La webform non è altro che un normale FORM HTML, con l’attributo runat=server. Poiché ogni pagina asp.net può contenere un solo form, una webform si identifica con una pagina ASP.NET. Ogni singola pagina è rappresentata da una classe che eredita da Page, classe base contenuta nel Namespace System.Web.UI. Come tutti i controlli, anche la pagina asp.net (e quindi la webform) risponde a degli eventi. Il primo ad essere invocato è PreInit, che si verifica prima dell’evento Init, che a sua volta si verifica all’atto della inizializzazione della classe che rappresenta la pagina. Successivamente si scatena l’evento Load, che è contestuale al caricamento della pagina e delle impostazioni delle sue proprietà. C’è anche l’evento Preload, che si verifica prima di Load. Successivamente ci sono gli eventi PreRender e Render, che segnano la generazione del codice X(HTML) associato. C’è poi l’evento Error che si verifica quando un’eccezione non gestita viene scatenata da uno degli oggetti della pagina. L’infrastruttura del Page Framework si basa su due concetti chiave, ViewState e PostBack, che rappresentano rispettivamente il contenitore ed il sistema attraverso il quale la pagina è in grado di preservare lo stato dei controlli e scatenare gli eventi associati. Esattamente un PostBack è un’azione attraverso la quale un controllo (che altro non è che un elemento HTML) inoltra nuovamente alla webform il contenuto dei suoi campi, in maniera tale che possa essere aggiornato lo stato e quello dei suoi contenuti. Il ViewState è invece il contenitore delle informazioni di stato, così che nel susseguirsi dei PostBack, che possono essere anche più di uno, lo sviluppatore non debba preoccuparsi di mantenere lo stato dei vari controlli. Se, per esempio, una webform è costituita da una casella di testo e da un pulsante, ogni volta che il pulsante viene premuto viene scatenato un evento PostBack, in seguito al quale le informazioni associate ai controlli (nell’esempio la casella di testo) sono salvate attraverso l’evento SaveState nel ViewState della pagina, così che, dai PostBack successivi, sfruttando l’evento LoadState della pagina, sia possibile recuperarli. Il risultato che si ottiene è che i controlli, automaticamente, mantengono il loro stato attraverso i vari PostBack, senza che lo sviluppatore debba implementare codice specifico. Il ViewState è implementato da un campo hidden aggiunto alla form, all’interno del quale vengono salvate le informazioni in codifica base 64. Le direttive di pagina All’interno del markup di una pagina sono presenti alcune istruzioni particolari, chiamate direttive, che sono utilizzate in fase di generazione della classe che la rappresenterà. Esse possono essere messe in qualunque punto della pagina, anche se solitamente sono inserite all’inizio. Le direttive sono contenute in blocchi di istruzioni racchiuse all’interno di parentesi acute, come di seguito indicato: <%@ … %> . La sintassi è del tipo: <%@ Direttiva attributo=”valore” %> In particolare la direttiva @Page definisce gli attributi specifici della pagina (file ASPX) utilizzati dal compilatore e dal parser di pagine ASP.NET. La sintassi è: <%@ Page attribute="value" [attribute="value"...] %> I principali attributi sono: AutoEventWireup Indica se gli eventi della pagina vengono connessi automaticamente, true indica che la connessione automatica degli eventi è attivata, false indica invece il caso contrario. L'impostazione predefinita è true. CodeFile Specifica il percorso del file code-behind cui si fa riferimento per la pagina. Questo attributo viene utilizzato insieme all'attributo Inherits per associare un file di origine codebehind a una pagina Web. L'attributo è valido solo per le pagine compilate. Language Specifica il linguaggio utilizzato nella compilazione del rendering inline (<% %> e <%= %>) e dei blocchi di dichiarazione del codice all'interno della pagina. I valori possono rappresentare qualsiasi linguaggio supportato da .NET Framework (Visual Basic, C#). Es. <%@ Page Language="VB" AutoEventWireup="false" CodeFile="Default.aspx.vb" Inherits="_Default" %> I WEB SERVER CONTROL Un controllo non è altro che un oggetto, implementato all’interno di una classe, in grado di offrire allo sviluppatore un certo insieme di funzionalità. I web server control sono controlli in grado di funzionare su pagine web eseguite lato server. Il parser tratta come server control solo quei tag che nel markup hanno l’attributo runat impostato su server. Tutti i controlli hanno come base la classe Control, che si trova nel namespace System.Web.UI. Questa classe garantisce che tutti i controlli abbiano alcune funzionalità in comune. All'interno dei server control si distinguono due grosse famiglie, gli html control ed i web control. I primi sono i normali tag dell'HTML con l'attributo runat sul valore server. Gli HtmlControl hanno in comune una classe base, HtmlControl, che si trova nel namespace System.Web.UI.HtmlControls. I WebControl, invece, si caratterizzano per il fatto di essere contenuti nel namespace System.Web.UI.WebControls e di avere come classe base WebControl, che a sua volta eredita dalla solita classe Control. Il modello ad oggetti di questi controlli è stato pensato ex novo per essere ottimizzato server side. I web Control si caratterizzano per il fatto di avere il prefisso <asp: all’interno della loro definizione nel markup, seguiti da una stringa che di fatto è il nome della classe nel namespace. Es. Una stringa come <asp:Label /> corrisponderà ad un’istanza della classe Label. Nella seguente tabella sono elencati i principali HtmlControls. Classe Descrizione HtmlAnchor Equivale all'elemento HTML <a> sul server. HtmlButton Equivale al tag HTML <button> sul server. HtmlForm Equivale all'elemento HTML <form> sul server. HtmlHead Equivale all'elemento HTML <head> sul server. HtmlImage Equivale all'elemento HTML <img> sul server. HtmlInputButton Equivale agli elementi HTML <input type= button>, <input type= submit> e <input type= reset> sul server. HtmlInputCheckBox Equivale all'elemento HTML <input type= checkbox> sul server. HtmlInputFile Equivale all'elemento HTML <input type= file> sul server. HtmlInputHidden Equivale all'elemento HTML <input type=hidden> sul server. HtmlInputImage Equivale all'elemento HTML <input type= image> sul server. HtmlInputPassword Equivale all'elemento HTML <input type= password> sul server. HtmlInputRadioButton Equivale all'elemento HTML <input type= radio> sul server. HtmlInputReset HtmlInputSubmit HtmlInputText HtmlLink HtmlMeta HtmlSelect HtmlTable HtmlTableCell HtmlTableRow HtmlTextArea HtmlTitle Equivale all'elemento HTML <input type=reset> sul server. Equivale all'elemento HTML <input type= submit> sul server. Equivale agli elementi HTML <input type= text> e <input type= password> sul server. Equivale all'elemento HTML <link> sul server. Equivale al tag HTML <meta> sul server. Equivale all'elemento HTML <select> sul server. Equivale all'elemento HTML <table> sul server. Equivale agi elementi HTML <td> e <th> in un oggetto HtmlTableRow. Equivale all’elemento HTML <tr> in un controllo HtmlTable. Equivale all'elemento HTML <textarea> sul server. Equivale all'elemento HTML <title> sul server. Web Control di base I controlli di base offrono funzionalità semplici, che vanno dal pulsante alla semplice etichetta o casella di testo. Nella seguente tabella sono elencati i principali WebControl. Classe Descrizione Button Visualizza nella pagina Web un controllo pulsante per l'esecuzione di un comando o per l'invio. CheckBox Consente di visualizzare una casella di controllo in cui è possibile selezionare una condizione true o false. CheckBoxList Definisce un gruppo di caselle di controllo a selezione multipla che può essere creato dinamicamente associando il controllo a una origine dati. DropDownList Rappresenta un controllo che consente all'utente di selezionare un singolo elemento da un elenco a discesa. HyperLink Un controllo in cui è visualizzato un collegamento a un'altra pagina Web. Image Visualizza un'immagine su una pagina Web. ImageButton Un controllo in cui viene visualizzata un'immagine e che risponde ai clic del mouse sull'immagine. Label Rappresenta un controllo etichetta, che consente di visualizzare del testo sulla pagina Web. LinkButton Visualizza un pulsante con lo stile di un collegamento. ListBox Rappresenta un controllo casella di riepilogo che consente di selezionare uno o più elementi. Panel Rappresenta un controllo utilizzato come contenitore per altri controlli. PlaceHolder È un segnaposto che serve per contenere controlli, senza racchiuderli all’interno di un tag. RadioButton Rappresenta un controllo pulsante di opzione. RadioButtonList Rappresenta un controllo elenco che incapsula un gruppo di controlli pulsanti di opzione. Visualizza un controllo di casella di testo per l'input dell'utente. TextBox Controllo Web Label Il controllo Web Label consente di impostare a livello di codice un testo da visualizzare in una pagina Web ASP.NET. Viene in genere utilizzato quando si desidera modificare il testo nella pagina in fase di esecuzione, ad esempio in risposta al clic su un pulsante. È possibile impostare la proprietà Text del controllo Label su una stringa qualsiasi, incluse stringhe contenenti tag. In questo caso, Label interpreterà i tag. Se ad esempio si imposta la proprietà Text su <b>Test</b>, il controllo Label eseguirà il rendering della parola Test in grassetto. La sintassi del controllo Label è <asp:Label>. Le principali proprietà del controllo Label sono elencate di seguito: Nome Descrizione BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta il contenuto del testo del controllo Label. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Controllo Web Button I pulsanti di una pagina Web ASP.NET consentono agli utenti di inviare un comando. I controlli server Web includono tre tipi di pulsante: un pulsante di comando (controllo Button), un pulsante con collegamento ipertestuale (controllo LinkButton) e un pulsante con immagine (controllo ImageButton). Tutti e tre forniscono funzionalità simili, ma ciascuno ha un aspetto diverso. Quando un utente fa clic su un controllo pulsante, viene eseguito il postback della pagina al server. Per impostazione predefinita, la pagina viene inviata a se stessa. La medesima pagina viene quindi rigenerata e i gestori eventi per i controlli contenuti nella pagina vengono eseguiti. La sintassi del controllo Label è <asp:Button>. Le principali proprietà del controllo Button sono elencate di seguito: Nome Descrizione BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. PostBackUrl Ottiene o imposta l'URL della pagina a cui effettuare l'invio dalla pagina corrente quando si fa clic sul controllo Button. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la didascalia di testo visualizzata nel controllo Button. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Controllo Link Button Il controllo LinkButton ha lo stesso aspetto di un controllo HyperLink, ma la funzionalità di un controllo Button. Per impostazione predefinita, un controllo LinkButton rappresenta un pulsante di invio. La sintassi del controllo Label è <asp:LinkButton> Le principali proprietà del controllo LinkButton sono elencate di seguito: BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. PostBackUrl Ottiene o imposta l'URL della pagina a cui effettuare l'invio dalla pagina corrente quando viene fatto clic sul controllo LinkButton. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la didascalia visualizzata sul controllo LinkButton. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Controllo Image Button Un controllo che si presenta come un controllo Image, ma si comporta come un controllo Button. La sintassi del controllo Label è <asp:ImageButton>. Le principali proprietà del controllo ImageButton sono elencate di seguito: BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se è possibile fare clic sul controllo ImageButton per eseguire un postback al server. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà dei caratteri per il testo associato al controllo. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. ImageAlign Ottiene o imposta l'allineamento del controllo Image in relazione ad altri elementi della pagina Web. ImageUrl Ottiene o imposta il percorso di un'immagine da visualizzare nel controllo Image. Page Ottiene un riferimento all'istanza Page che contiene il controllo server. PostBackUrl Ottiene o imposta l'URL della pagina a cui effettuare l'invio dalla pagina corrente quando viene fatto clic sul controllo ImageButton. Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio <asp:ImageButton ID="ImageButton1" runat="server" Height="78px" ImageUrl="~/Immagini/Tramonto.jpg" Width="113px" ImageAlign="left" /> <h3>Esempio ImageButton</h3> Clicca dovunque sull’immagine. <br><br> <br><br> <asp:label id="Label1" runat="server"/> Protected Sub ImageButton1_Click(ByVal sender As Object, ByVal e As System.Web.UI.ImageClickEventArgs) Handles ImageButton1.Click Label1.Text = "Hai cliccato sull’ImageButton alle coordinate: (" & _ e.X.ToString() & ", " & e.Y.ToString() & ")" End Sub Controllo ListBox Rappresenta un controllo casella di riepilogo che consente di selezionare uno o più elementi. La sintassi è la seguente: <asp:ListBox > <asp:ListItem>...</asp:ListItem> ... <asp:ListItem>…</asp:ListItem> </asp:ListBox> Le principali proprietà del controllo ListBox sono elencate di seguito: Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se si verifica un postback automatico al server quando l'utente modifica la selezione dell'elenco. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo. BorderStyle Ottiene o imposta lo stile del bordo del controllo. BorderWidth Ottiene o imposta la larghezza del bordo per il controllo. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Items Ottiene l'insieme degli elementi del controllo elenco. Rows Ottiene o imposta il numero di righe visualizzate nel controllo ListBox. SelectedIndex Ottiene o imposta l'indice ordinale più basso degli elementi selezionati nell'elenco. SelectedItem Ottiene l'elemento selezionato con l'indice più basso nel controllo elenco. SelectedValue Ottiene il valore dell'elemento selezionato nel controllo elenco o seleziona l'elemento nel controllo elenco che contiene il valore specificato. SelectionMode Ottiene o imposta la modalità di selezione del controllo ListBox. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la proprietà SelectedValue del controllo ListControl. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio <asp:Image ID="Image1" runat="server" ImageUrl="~/Immagini/books1.jpg" /> <br /><br /> <asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True"> <asp:ListItem>books1</asp:ListItem> <asp:ListItem>books2</asp:ListItem> <asp:ListItem>books3</asp:ListItem> </asp:ListBox> Protected Sub ListBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles ListBox1.SelectedIndexChanged Image1.ImageUrl = "Immagini/" & ListBox1.SelectedItem.Value & ".jpg" End Sub Controllo server HyperlinK Il controllo HyperLink viene usato per creare un collegamento a un'altra pagina Web. Esso è visualizzato in genere come testo specificato dalla proprietà Text. Può anche essere visualizzato sotto forma di immagine, specificata dalla proprietà ImageUrl. Se sono impostate le proprietà Text e ImageUrl, la proprietà ImageUrl ha la precedenza. Se l'immagine non è disponibile, viene visualizzato il testo presente nella proprietà Text. La sintassi è <asp:HyperLink> Le principali proprietà del controllo HyperLink sono elencate di seguito: Nome Descrizione BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. ImageUrl Ottiene o imposta il percorso di un'immagine da visualizzare per il controllo HyperLink. NavigateUrl Ottiene o imposta l'URL al quale eseguire il collegamento quando si fa clic sul controllo HyperLink. Page Ottiene un riferimento all'istanza Page che contiene il controllo server. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Target Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web collegato quando viene fatto clic sul controllo HyperLink. Text Ottiene o imposta la didascalia per il controllo HyperLink. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio <h3>HyperLink Example</h3> Click on the HyperLink:<br> <asp:HyperLink id="hyperlink1" ImageUrl="images/pict.jpg" NavigateUrl="http://www.microsoft.com" Text="Microsoft Official Site" Target="_new" runat="server"/> Controllo Image Il controllo Image consente di visualizzare un'immagine sulla pagina Web. Il percorso dell'immagine visualizzata è specificato impostando la proprietà ImageUrl. È possibile specificare il testo da visualizzare al posto dell'immagine quando quest'ultima non è disponibile impostando la proprietà AlternateText. L'allineamento dell'immagine in relazione ad altri elementi della pagina Web è specificato mediante l'impostazione della proprietà ImageAlign. La sintassi è <asp:Image>. Le principali proprietà sono: Nome Descrizione AlternateText Ottiene o imposta il testo alternativo visualizzato nel controllo Image quando l'immagine non è disponibile. Nei browser che supportano la funzione di descrizione comandi, il testo viene visualizzato come descrizione. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. DescriptionUrl Ottiene o imposta la posizione su una descrizione dettagliata dell'immagine. Enabled Ottiene o imposta un valore che indica se il controllo è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà dei caratteri per il testo associato al controllo. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. ImageAlign Ottiene o imposta l'allineamento del controllo Image in relazione ad altri elementi della pagina Web. ImageUrl Ottiene o imposta il percorso di un'immagine da visualizzare nel controllo Image. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Controllo Panel Il controllo Panel è un contenitore per altri controlli e risulta particolarmente utile per generare controlli a livello di codice, per nascondere e mostrare un gruppo di controlli o per localizzare un gruppo di controlli. La sintassi è <asp:Panel>. Le principali proprietà sono: Nome Descrizione BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BackImageUrl Ottiene o imposta l'URL dell'immagine di sfondo per il controllo del pannello. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. HorizontalAlign Ottiene o imposta l'allineamento orizzontale del contenuto all'interno del pannello. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. ScrollBars Ottiene o imposta la visibilità e la posizione delle barre di scorrimento in un controllo Panel. Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Wrap Ottiene o imposta un valore che indica se il contenuto va a capo nel pannello. Esempio <asp:Panel id="panel1" runat="server" BackColor="#ff0000" Height="100px" Width="100px"> Hello World! </asp:Panel> <asp:CheckBox id="check1" Text="Hide Panel control" runat="server"/> <br /><br /> <asp:Button ID="Button1" Text="Reload" runat="server" /> Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load If check1.Checked Then panel1.Visible = False Else panel1.Visible = True End If End Sub Controllo checkbox Consente di visualizzare una casella di controllo in cui è possibile selezionare una condizione true o false. La sintassi è: <asp:CheckBox> Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se lo stato del controllo CheckBox viene automaticamente inviato di nuovo al server quando è selezionato. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. Checked Ottiene o imposta un valore che indica se il controllo CheckBox è selezionato. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta l’etichetta di testo associata al controllo CheckBox. TextAlign Ottiene o imposta l’allineamento dell'etichetta di testo associata al controllo CheckBox. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio <asp:Panel id="panel1" runat="server" BackColor="#ff0000" Height="100px" Width="100px"> Hello World! </asp:Panel> <asp:CheckBox id="check1" Text="Hide Panel control" runat="server"/> <br /><br /> <asp:Button ID="Button1" Text="Reload" runat="server" /> Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load If check1.Checked Then panel1.Visible = False Else panel1.Visible = True End If End Sub Controllo checkboxList Il controllo CheckBoxList fornisce un gruppo di caselle di controllo a selezione multipla. Contiene un insieme Items con membri che corrispondono a singoli elementi nell'elenco. Per determinare quali elementi sono selezionati, bisogna scorrere l'insieme e verificare la proprietà Selected di ciascun elemento nell'elenco. La sintassi è: <asp:CheckBoxList runat="server"> <asp:ListItem>Item 1</asp:ListItem> ... <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> Le principali proprietà sono: Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se si verifica un postback automatico al server quando l'utente modifica la selezione dell'elenco. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CellPadding Ottiene o imposta la distanza in pixel fra il bordo e il contenuto della cella. CellSpacing Ottiene o imposta la distanza in pixel fra le celle. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Items Ottiene l'insieme degli elementi del controllo elenco. Page Ottiene un riferimento all'istanza Page che contiene il controllo server. RepeatColumns Ottiene o imposta il numero di colonne da visualizzare nel controllo CheckBoxList. RepeatDirection Ottiene o imposta un valore che indica se il controllo viene visualizzato verticalmente o orizzontalmente. SelectedIndex Ottiene o imposta l'indice ordinale più basso degli elementi selezionati nell'elenco. SelectedItem Ottiene l'elemento selezionato con l'indice più basso nel controllo elenco. SelectedValue Ottiene il valore dell'elemento selezionato nel controllo elenco o seleziona l'elemento nel controllo elenco che contiene il valore specificato. Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. SkinID Ottiene o imposta l'interfaccia da applicare al controllo. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la proprietà SelectedValue del controllo ListControl. TextAlign Ottiene o imposta l'allineamento del testo delle caselle di controllo all'interno del gruppo. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio <h3> CheckBoxList Example </h3> Select items from the CheckBoxList. <br><br> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" RepeatColumns="2" RepeatDirection="Vertical" TextAlign="Right" runat="server"> <asp:ListItem>Item <asp:ListItem>Item <asp:ListItem>Item <asp:ListItem>Item <asp:ListItem>Item <asp:ListItem>Item 1</asp:ListItem> 2</asp:ListItem> 3</asp:ListItem> 4</asp:ListItem> 5</asp:ListItem> 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> Protected Sub Check_Clicked(ByVal sender As Object, ByVal e As System.EventArgs) Handles checkboxlist1.SelectedIndexChanged Message.Text = "Selected Item(s):<br><br>" ' Iterate through the Items collection of the CheckBoxList ' control and display the selected items. Dim i As Integer For i = 0 To checkboxlist1.Items.Count - 1 If checkboxlist1.Items(i).Selected Then Message.Text &= checkboxlist1.Items(i).Text & "<br>" End If Next End Sub Control DropDownList È un controllo che consente all'utente di selezionare un singolo elemento da un elenco a discesa. Per specificare gli elementi da visualizzare nel controllo DropDownList, bisogna inserire un oggetto ListItem per ciascuna voce tra i tag di apertura e di chiusura del controllo DropDownList. Utilizzare la proprietà SelectedIndex per determinare a livello di codice l'indice dell'elemento selezionato dall'utente nel controllo DropDownList. La sintassi è: <asp:DropDownList> <asp:ListItem>…</asp:ListItem> … <asp:ListItem>…</asp:ListItem> </asp:DropDownList> Le principali proprietà sono: Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se si verifica un postback automatico al server quando l'utente modifica la selezione dell'elenco. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Sottoposto a override. Ottiene o imposta il colore del bordo del controllo. BorderStyle Sottoposto a override. Ottiene o imposta lo stile del bordo del controllo. BorderWidth Sottoposto a override. Ottiene o imposta la larghezza del bordo per il controllo. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Items Ottiene l'insieme degli elementi del controllo elenco. SelectedIndex Sottoposto a override. Ottiene o imposta l'indice dell'elemento selezionato nel controllo DropDownList. SelectedItem Ottiene l'elemento selezionato con l'indice più basso nel controllo elenco. SelectedValue Ottiene il valore dell'elemento selezionato nel controllo elenco o seleziona l'elemento nel controllo elenco che contiene il valore specificato. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la proprietà SelectedValue del controllo ListControl. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio: <asp:Image ID="Image1" runat="server" ImageUrl="~/Immagini/books1.jpg" /><br /> <br /> <asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True"> <asp:ListItem>books1</asp:ListItem> <asp:ListItem>books2</asp:ListItem> <asp:ListItem>books3</asp:ListItem> </asp:DropDownList>&nbsp;</div> Protected Sub DropDownList1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles DropDownList1.SelectedIndexChanged Image1.ImageUrl = "Immagini/" & DropDownList1.SelectedItem.Value & ".jpg" End Sub Controllo RadioButton Rappresenta un controllo pulsante di opzione. I pulsanti sono raggruppati in modo logico se condividono la stessa proprietà GroupName. La sintassi è <asp:RadioButton>. Le principali proprietà sono: Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se lo stato del controllo CheckBox viene automaticamente inviato di nuovo al server quando è selezionato. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. Checked Ottiene o imposta un valore che indica se il controllo CheckBox è selezionato. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. GroupName Ottiene o imposta il nome del gruppo cui appartiene il pulsante di opzione. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta l’etichetta di testo associata al controllo CheckBox. TextAlign Ottiene o imposta l’allineamento dell'etichetta di testo associata al controllo CheckBox. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio radiobutton <asp:Image ID="Image1" runat="server" ImageUrl="~/Immagini/books1.jpg" /> <br /> Scegli il libro<br /> <asp:RadioButton ID="RadioButton1" runat="server" GroupName="RdLibro" Text="books1" AutoPostBack="True"/> <asp:RadioButton ID="RadioButton2" runat="server" GroupName="RdLibro" Text="books2" AutoPostBack="True"/> <asp:RadioButton ID="RadioButton3" runat="server" GroupName="RdLibro" Text="books3" AutoPostBack="True"/> Protected Sub RadioButton2_CheckedChanged(ByVal sender As System.EventArgs) Handles RadioButton2.CheckedChanged Image1.ImageUrl = "Immagini/" & RadioButton2.Text & ".jpg" End Sub Object, ByVal e As Protected Sub RadioButton1_CheckedChanged(ByVal sender As System.EventArgs) Handles RadioButton1.CheckedChanged Image1.ImageUrl = "Immagini/" & RadioButton1.Text & ".jpg" End Sub Object, ByVal e As Protected Sub RadioButton3_CheckedChanged(ByVal sender As System.EventArgs) Handles RadioButton3.CheckedChanged Image1.ImageUrl = "Immagini/" & RadioButton3.Text & ".jpg" End Sub Object, ByVal e As Controllo Rabiobuttonlist Il controllo RadioButtonList fornisce un gruppo di pulsanti di opzione a selezione singola. Tale gruppo contiene un insieme Items con membri che corrispondono ai singoli elementi dell'elenco. Per determinare l'elemento selezionato, controllare la proprietà SelectedItem dell'elenco. La sintassi è <asp:RadioButtonList runat="server"> <asp:ListItem selected="true">Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> </asp:RadioButtonList> Le principali proprietà sono: Nome Descrizione AutoPostBack Ottiene o imposta un valore che indica se si verifica un postback automatico al server quando l'utente modifica la selezione dell'elenco. BackColor Ottiene o imposta il colore di sfondo del controllo server Web. BorderColor Ottiene o imposta il colore del bordo del controllo Web. BorderStyle Ottiene o imposta lo stile del bordo del controllo server Web. BorderWidth Ottiene o imposta la larghezza del bordo del controllo server Web. CausesValidation Ottiene o imposta un valore che indica se quando si fa clic su un controllo derivato dalla classe ListControl viene eseguita la convalida. CssClass Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. Enabled Ottiene o imposta un valore che indica se il controllo server Web è attivato. EnableViewState Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. Font Ottiene le proprietà del carattere associate al controllo server Web. ForeColor Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. Height Ottiene o imposta l'altezza del controllo server Web. ID Ottiene o imposta l'identificatore a livello di programmazione assegnato al controllo server. Items Ottiene l'insieme degli elementi del controllo elenco. RepeatColumns Ottiene o imposta il numero di colonne da visualizzare nel controllo RadioButtonList. RepeatDirection Ottiene o imposta la direzione in cui sono visualizzati i pulsanti di opzione all'interno del gruppo. SelectedIndex Ottiene o imposta l'indice ordinale più basso degli elementi selezionati nell'elenco. SelectedItem Ottiene l'elemento selezionato con l'indice più basso nel controllo elenco. SelectedValue Ottiene il valore dell'elemento selezionato nel controllo elenco o seleziona l'elemento nel controllo elenco che contiene il valore specificato. Site Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. Style Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. TabIndex Ottiene o imposta l'indice di tabulazione del controllo server Web. Text Ottiene o imposta la proprietà SelectedValue del controllo ListControl. TextAlign Ottiene o imposta l'allineamento del testo per i pulsanti di opzione all'interno del gruppo. ToolTip Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. Visible Ottiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. Width Ottiene o imposta la larghezza del controllo server Web. Esempio radiobuttonlist <asp:Image ID="Image1" runat="server" ImageUrl="~/immagini/books1.jpg" /><br /> <asp:RadioButtonList id="radiolist1" runat="server" AutoPostBack="True"> <asp:ListItem selected="True">books1</asp:ListItem> <asp:ListItem>books2</asp:ListItem> <asp:ListItem>books3</asp:ListItem> </asp:RadioButtonList> Protected Sub radiolist1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles radiolist1.SelectedIndexChanged Image1.ImageUrl = "immagini/" & radiolist1.SelectedItem.Text & ".jpg" End Sub Controllo PlaceHolder È un segnaposto che serve per contenere controlli, senza racchiuderli all’interno di un tag. Esempio <asp:PlaceHolder ID="inputs" runat="server"> <br /> Nome:<asp:TextBox ID="FirstName" runat="server"></asp:TextBox> <br /> Cognome:<asp:TextBox ID="SecondName" runat="server"></asp:TextBox> <br /> <br /> <asp:Button ID="SubmitButton" runat="server" Text="Provami" /> </asp:PlaceHolder> </div> <asp:PlaceHolder ID="Results" runat="server" Visible=false> <br /> <br /> Hai detto di chiamarti: <asp:Label ID="ResultaName" runat="server" Text=""></asp:Label> </asp:PlaceHolder> Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles SubmitButton.Click Inputs.Visible = False Results.Visible = True ResultaName.Text = FirstName.Text & " " & SecondName.Text End Sub