Condividi tramite

Procedura: includere un controllo utente in una pagina Web ASP.NET

  • Articolo

Aggiornamento: novembre 2007

Per utilizzare un controllo utente, è necessario includerlo in una pagina Web ASP.NET. Quando viene richiesta una pagina contenente un controllo utente, quest'ultimo passa attraverso tutte le fasi di elaborazione eseguite dai controlli server ASP.NET. Per ulteriori informazioni su queste fasi di elaborazione, vedere Cenni preliminari sul ciclo di vita di una pagina ASP.NET.

Per includere un controllo utente in una pagina Web Form

  1. Nella pagina Web ASP.NET in oggetto, creare 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 che si sta includendo.

      Nota:

      Il valore dell'attributo Src può essere un percorso relativo o assoluto per il file di origine del controllo utente a partire dalla directory principale dell'applicazione. Per esigenze di flessibilità, si consiglia di utilizzare un percorso relativo. Il carattere tilde (~) rappresenta la directory principale dell'applicazione. I controlli utente non possono essere inseriti nella directory App_Code.

  2. Nel corpo della pagina Web, dichiarare l'elemento del controllo utente all'interno dell'elemento form.

  3. Se il controllo utente espone proprietà pubbliche, impostare, eventualmente, tali proprietà in modo dichiarativo.

Esempio

Nel seguente esempio viene illustrata una pagina Web ASP.NET che contiene un controllo utente. Il controllo utente si trova nel file Spinner.ascx nella cartella dei controlli. Nella pagina, il controllo viene registrato in modo da utilizzare il prefisso uc e il Tag Name Spinner. Le proprietà MinValue e MaxValue del controllo utente vengono impostate in modo dichiarativo.

Nota:

Per ulteriori informazioni sul codice per il controllo utente utilizzato in questo esempio, vedere Procedura: creare controlli utente ASP.NET.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

Vedere anche

Concetti

Cenni preliminari sui controlli utente ASP.NET

Guida di orientamento alla creazione di controlli ASP.NET personalizzati