Generazione degli esempi dei controlli server personalizzati

Articolo
10/22/2014

Aggiornamento: novembre 2007

Questo argomento descrive come compilare gli esempi dei controlli personalizzati in un assembly e come utilizzare i controlli nelle pagine Web ASP.NET. Descrive inoltre come utilizzare la cartella App_Code di un sito Web ASP.NET per verificare il codice dei controlli senza doverli compilare.

Generazione di un assembly del controllo

Per creare e compilare i controlli personalizzati in un assembly

Creare una cartella per i file sorgente per i controlli personalizzati e le classi correlate.
Creare un file di testo con l'estensione del linguaggio appropriato per tutti gli esempi che si desiderano compilare.

Ad esempio, creare un file denominato MailLink.cs per il codice C# del controllo MailLink in Esempio di rendering di controlli Web.
Copiare e incollare il codice sorgente di ogni esempio nel file di testo corrispondente e salvare il file.

Eseguire il comando seguente dalla cartella del codice sorgente per compilare i controlli e le classi correlate in un assembly.

csc /t:library /out:Samples.AspNet.CS.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.cs

vbc /t:library /out:Samples.AspNet.VB.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.vb

L'opzione del compilatore /t:library richiede al compilatore di creare una libreria (invece di un assembly eseguibile). L'opzione /out fornisce un nome per l'assembly e l'opzione /r elenca gli assembly collegati all'assembly specifico.

Nota:
Se non è possibile eseguire il comando del compilatore, è necessario aggiungere il percorso di installazione .NET Framework alla variabile Windows PATH prima di eseguire il comando. In Windows, fare clic con il pulsante destro del mouse su Risorse del computer, selezionare Proprietà, quindi selezionare la scheda Avanzate e fare clic sul pulsante Variabili d'ambiente. Nell'elenco Variabili di sistema, fare doppio clic sulla variabile Path. Nella casella di testo Valore variabile, aggiungere un punto e virgola (;) alla fine dei valori presenti nella casella di testo, quindi digitare il percorso di installazione di .NET Framework. .NET Framework viene in genere installato nella cartella di installazione nel percorso Windows in \Microsoft.NET\Framework\versionNumber.

Se non è possibile eseguire il comando del compilatore, è necessario aggiungere il percorso di installazione .NET Framework alla variabile Windows PATH prima di eseguire il comando. In Windows, fare clic con il pulsante destro del mouse su Risorse del computer, selezionare Proprietà, quindi selezionare la scheda Avanzate e fare clic sul pulsante Variabili d'ambiente. Nell'elenco Variabili di sistema, fare doppio clic sulla variabile Path. Nella casella di testo Valore variabile, aggiungere un punto e virgola (;) alla fine dei valori presenti nella casella di testo, quindi digitare il percorso di installazione di .NET Framework. .NET Framework viene in genere installato nella cartella di installazione nel percorso Windows in \Microsoft.NET\Framework\versionNumber.

Eseguire nuovamente il comando al passaggio 4 quando si desidera aggiungere nuovi file sorgente alla cartella del codice sorgente o sostituire i file presenti.

Generazione di un sito Web ASP.NET

Per creare un sito Web ASP.NET

Creare un sito Web ASP.NET utilizzando Internet Information Services (IIS) o un altro strumento.
Per informazioni sulla generazione e sulla configurazione di una directory virtuale IIS, vedere Procedura: creare e configurare directory virtuali in IIS 5.0 e 6.0.

Nota:

Se si desidera utilizzare IIS, installarlo prima di .NET Framework.
Creare una cartella Bin nella cartella principale del sito Web.
Copiare l'assembly generato con la routine precedente nella cartella Bin del sito Web.

Nota:

Durante la ricompilazione dell'assembly del controllo, l'ultimo passaggio nella sezione precedente, è necessario copiare il nuovo assembly nella cartella Bin del sito Web.

Nota:
Se si desidera utilizzare IIS, installarlo prima di .NET Framework.

Nota:
Durante la ricompilazione dell'assembly del controllo, l'ultimo passaggio nella sezione precedente, è necessario copiare il nuovo assembly nella cartella Bin del sito Web.

Creare un file di testo Web.config nella cartella principale del sito Web, aggiungere il seguente codice XML al file Web.config, quindi salvarlo.

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.CS.Controls" 
          assembly="Samples.AspNet.CS.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.VB.Controls" 
          assembly="Samples.AspNet.VB.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

Aggiungere un file di testo con estensione aspx nella cartella principale del sito Web per tutti gli esempi di cui si desidera eseguire il test.

Ad esempio, creare un file denominato MailLinkTest.aspx per testare la pagina del controllo MailLink in Esempio di rendering di controlli Web.
Copiare e incollare il codice sorgente di ogni pagina di test dell'esempio nel file corrispondente aspx e salvare il file.
Avviare la richiesta di pagine aspx in un browser Web.

Ad esempio, se il sito Web è denominato ServerControls e include una pagina denominata MailLinkTest.aspx, digitare l'URL seguente nella barra degli indirizzi del browser:
```
https://localhost/ServerControls/MailLinkTest.aspx
```

Utilizzo della cartella App_Code per verificare i controlli

È possibile utilizzare la funzionalità di compilazione dinamica di ASP.NET 2.0 per verificare i controlli senza la necessità di doverli compilare manualmente in un assembly.

Per salvare i controlli nella cartella App_Code

Creare una cartella App_Code nella cartella principale del sito Web.
Copiare i file sorgente per i controlli e le classi correlate nella cartella App_Code.

Se è già presente un assembly per il controllo nella cartella Bin, eliminarlo.

Nota:
È possibile precompilare un controllo in un assembly e salvarlo nella cartella Bin o salvare il file sorgente del controllo nella cartella App_Code. Se si salva il controllo in entrambe le cartelle, il parser della pagina non sarà in grado di risolvere un riferimento per il controllo in una pagina e genererà un errore.

Sostituire la voce nella sezione controls del file Web.config con la voce evidenziata riportata di seguito, che mappa lo spazio dei nomi del controllo a un prefisso del tag:
```
<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.CS.Controls">..</add>
</controls>
```
```
<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.VB.Controls">..</add>
</controls>
```
Per ulteriori informazioni, vedere @ Register.
Avviare la richiesta delle pagine aspx in un browser Web.

Se si salvano i file sorgente per le classi QuickContacts e ContactCollectionEditor da Esempio di proprietà Collection di Web Control nella cartella App_Code, è necessario aggiungere anche un riferimento all'assembly System.Design nella sezione compilation del file Web.config. Questo riferimento richiede il nome completo dell'assembly System.Design. È possibile ottenere le informazioni richieste per il nome completo eseguendo Strumento Global Assembly Cache (Gacutil.exe) fornito con Windows Software Development Kit (SDK) e utilizzando la sintassi seguente:

gacutil /l System.Design

Nota:
Per eseguire Strumento Global Assembly Cache (Gacutil.exe) dalla riga di comando, la variabile di ambiente Windows PATH per il computer in uso deve includere il percorso di installazione di .NET Framework. In Windows, fare clic con il pulsante destro del mouse su Risorse del computer, selezionare Proprietà, quindi selezionare la scheda Avanzate e fare clic sul pulsante Variabili d'ambiente. Nell'elenco Variabili di sistema, fare doppio clic sulla variabile Path. Nella casella di testo Valore variabile, aggiungere un punto e virgola (;) alla fine dei valori presenti nella casella di testo, quindi digitare il percorso di installazione di .NET Framework. .NET Framework viene in genere installato nella cartella di installazione nel percorso Windows in \Microsoft.NET\Framework\versionNumber.

Per eseguire Strumento Global Assembly Cache (Gacutil.exe) dalla riga di comando, la variabile di ambiente Windows PATH per il computer in uso deve includere il percorso di installazione di .NET Framework. In Windows, fare clic con il pulsante destro del mouse su Risorse del computer, selezionare Proprietà, quindi selezionare la scheda Avanzate e fare clic sul pulsante Variabili d'ambiente. Nell'elenco Variabili di sistema, fare doppio clic sulla variabile Path. Nella casella di testo Valore variabile, aggiungere un punto e virgola (;) alla fine dei valori presenti nella casella di testo, quindi digitare il percorso di installazione di .NET Framework. .NET Framework viene in genere installato nella cartella di installazione nel percorso Windows in \Microsoft.NET\Framework\versionNumber.

Il tag aggiunto alla sezione compilation del file Web.config è simile alla sezione evidenziata nell'esempio seguente. Tuttavia, è necessario sostituire i valori degli attributi Version e PublicKeyToken con i valori restituiti dallo strumento Gacutil.exe.

<compilation >
  <assemblies>    <add assembly="System.Design, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />    </assemblies>
</compilation>

Nota:
Se si utilizza un ambiente di sviluppo integrato, la finestra di progettazione deve fornire una tecnica più semplice per aggiungere un riferimento dell'assembly al file Web.config. Ad esempio, in Visual Studio 2005, se si fa clic con il pulsante destro del mouse sul nome del sito Web in Esplora soluzioni e si sceglie Aggiungi riferimento nel menu di scelta rapida, è possibile utilizzare una finestra di dialogo che consente la selezione dell'assembly da aggiungere. Quando si seleziona l'assembly, la finestra di progettazione aggiunge automaticamente la voce rilevante nel file Web.config.

Se si utilizza un ambiente di sviluppo integrato, la finestra di progettazione deve fornire una tecnica più semplice per aggiungere un riferimento dell'assembly al file Web.config. Ad esempio, in Visual Studio 2005, se si fa clic con il pulsante destro del mouse sul nome del sito Web in Esplora soluzioni e si sceglie Aggiungi riferimento nel menu di scelta rapida, è possibile utilizzare una finestra di dialogo che consente la selezione dell'assembly da aggiungere. Quando si seleziona l'assembly, la finestra di progettazione aggiunge automaticamente la voce rilevante nel file Web.config.

Vedere anche

Attività

Procedura dettagliata: sviluppo e utilizzo di un controllo server personalizzato

Altre risorse

Sviluppo di controlli server ASP.NET personalizzati

Condividi tramite