Creazione di un controllo utente

Articolo
04/11/2008

È possibile creare un controllo utente in modo dichiarativo, utilizzando un editor HTML o di testo. La sintassi dichiarativa dei controlli utente è molto simile a quella utilizzata per creare una pagina Web Form. La differenza principale consiste nel fatto che i controlli utente non racchiudono il contenuto in elementi <html>, <body> e <form>. Tali elementi verranno inclusi nelle pagine Web Form contenenti il controllo utente. Per ulteriori informazioni sulle pagine Web Form e su come crearle, vedere Introduzione alle pagine Web Form. Per informazioni sulla dichiarazione di un controllo utente in una pagina Web Form, vedere Inclusione di un controllo utente in una pagina Web Form.

I controlli utente possono essere semplici file di testo oppure contenere altri controlli server ASP.NET. Nella procedura riportata di seguito viene illustrato un semplice form che è possibile includere in più pagine di un'applicazione.

Nota Quando si crea un'applicazione Web utilizzando Visual Studio .NET, tutte le pagine e i controlli utente dell'applicazione devono essere scritti con lo stesso linguaggio di programmazione.

Per creare un controllo utente

Aprire un editor HTML o di testo e creare un blocco di dichiarazione di codice che esponga proprietà, gestori eventi e altro codice da includere nelle funzionalità del controllo utente.

Quando si utilizzano le proprietà dei controlli utente sono disponibili due opzioni. La prima consiste nel definire nuove proprietà modificabili per il controllo utente. La seconda consiste invece nel modificare le proprietà dei controlli server che costituiscono il controllo utente. Se ad esempio si dichiara un controllo server Web TextBox in un controllo utente e vi si associa l'ID MyTextbox, sarà possibile modificarne la proprietà Text utilizzando la sintassi MyTextbox.Text.

**Nota **Tutte le proprietà e i metodi dei controlli server ASP.NET che costituiscono un controllo utente incluso in una pagina Web Form divengono proprietà e metodi pubblici del controllo utente.

Nell'esempio seguente viene dichiarato un gestore eventi myButton_Click, che viene chiamato quando un utente fa clic sul controllo server Web Button creato al passaggio 2. Con questo metodo viene effettuato l'accesso al testo digitato dall'utente nel controllo server Web TextBox e il testo viene visualizzato in un controllo server Label.
```
<script language="VB" runat="server">
   Public Sub myButton_Click(sender As Object, e As EventArgs)
      output.Text = "Hello, " + name.Text + "."
   End Sub 'myButton_Click 
</script>
[C#]
<script language="C#" runat="server">
   public void myButton_Click(object sender, EventArgs e)
   {
      output.Text = "Hello, " + name.Text + ".";
   }
</script>
```

Creare gli elementi di interfaccia utente che si desidera visualizzare nel controllo utente. Nel tag che segue viene ad esempio creata l'interfaccia utente che interagisce con il codice riportato al passaggio 1.

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing=15>
 <tr>
   <td><b>Enter your name here: </b></td>
   <td><ASP:TextBox id="name" runat="server"/></td>
 </tr>
 <tr>
   <td><b><ASP:Label id="output" runat="server"/></b></td>
 </tr>
 <tr>
   <td></td>
   <td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
 </tr>
</table>

Denominare il controllo utente e salvarlo in un file con estensione ASCX, ad esempio frmGreet.ascx.

Nota Quando si include questo controllo utente in una pagina Web Form, è necessario includere il nome file e il percorso nell'attributo Src della direttiva @ Register.

Vedere anche

Controlli utente Web Form | Inclusione di un controllo utente in una pagina Web Form | Gestione di eventi server nelle pagine Web Form

Creazione di un controllo utente

Vedere anche

Risorse aggiuntive