Inclusione di un controllo utente in una pagina Web Form

  • Articolo

I controlli utente funzionano solo quando sono inclusi in una pagina Web Form. Quando viene richiesta una pagina contenente un controllo utente, il controllo utente passa attraverso tutte le fasi di elaborazione a cui sono soggetti i controlli server ASP.NET. Per ulteriori informazioni su tali fasi di elaborazione, vedere Elaborazione di pagine Web Form.

L'inclusione di un controllo utente in una pagina Web Form è un'operazione semplice.

Per includere un controllo utente in una pagina Web Form

  1. Nella pagina Web Form contenitore, dichiarare una direttiva @ Register che includa:

    • Un attributo tagprefix, che associa un prefisso al controllo utente. Questo prefisso verrà incluso nel tag di apertura dell'elemento controllo utente.

    • Un attributo tagname, che associa un nome al controllo utente. Questo nome verrà incluso nel tag di apertura dell'elemento controllo utente.

    • Un attributo Src, che definisce il percorso virtuale del file del controllo utente da includere nella pagina Web Form.

      Nota   Il valore dell'attributo Src può essere sia un percorso relativo, sia un percorso assoluto del file di origine del controllo utente dalla directory principale dell'applicazione. Per praticità, si consiglia di utilizzare un percorso relativo. Il carattere tilde (~) rappresenta la directory principale dell'applicazione.

    Nel codice che segue, ad esempio, viene registrato un controllo utente definito nel file Login1.ascx. A tale controllo sono stati assegnati il prefisso Acme e il nome Login. Il file si trova in una directory Controls.

    <%@ Register TagPrefix="Acme" TagName="Login" Src="~\controls\login1.ascx" %>

  2. Utilizzando la sintassi dei controlli server personalizzati, dichiarare l'elemento controllo utente tra i tag di apertura e chiusura del controllo server HtmlForm (<form runat=server></form>). Per dichiarare ad esempio il controllo importato al passaggio precedente, utilizzare la sintassi riportata di seguito.

    <html>
<body>
<form runat="server">
<Acme:Login id="MyLogin" runat="server"/>
</form>
</body>
</html>

    Nota   Indipendentemente dal numero di controlli server ASP.NET (controlli utente e altri controlli) inclusi nella pagina Web Form, in una pagina Web Form è necessario includere un solo controllo server HtmlForm. Includere tutti i controlli server tra i tag di apertura e chiusura di tale controllo.

Vedere anche

Controlli utente Web Form | Creazione di un controllo utente | Gestione di eventi server nelle pagine Web Form | Gestione degli eventi dei controlli utente