Registrare un assembly in un WebForm per usare un controllo personalizzato

Questo articolo fornisce informazioni per rendere e registrare un assembly disponibile in un WebForm da usare con ASP.NET controlli server personalizzati.

Versione originale del prodotto: ASP.NET
Numero KB originale: 321749

Proprietà di assembly di esempio

Per essere rappresentato come controllo server personalizzato, l'assembly deve avere una classe che deriva direttamente o indirettamente da System.Web.UI.Control ed è necessario racchiudere la classe in uno spazio dei nomi. Gli esempi in questo articolo presuppongono che la classe sia racchiusa nello CustomControlNamespace spazio dei nomi e che l'assembly sia stato compilato correttamente in un file denominato CustomControl.dll.

Rendere disponibile un assembly per ASP.NET'applicazione

Per rendere disponibile un assembly per un'applicazione ASP.NET, è necessario inserire il .dll dell'assembly nella /bin cartella dell'applicazione.

1. Passare alla directory radice dell'applicazione in Esplora risorse.

   Per scoprire qual è la cartella del progetto dell'applicazione:

   1. Nell'ambiente .NET, nel menu Visualizza selezionare Esplora soluzioni.
   2. Fare clic con il pulsante destro del mouse su un elemento principale del progetto in Esplora soluzioni e scegliere Proprietà.
   3. Nella finestra di dialogo Proprietà progetto selezionare Proprietà comuni e selezionare Generale.

   Nel riquadro dell'albero viene visualizzato l'elenco con la proprietà Cartella di progetto . Si tratta in genere della directory radice dell'applicazione.

2. In una cartella di progetto applicazione Web creare una cartella denominata bin se non esiste.

3. Copiare o spostare la .dll dell'assembly in questa cartella. È ora possibile usare il controllo da qualsiasi pagina ASP.NET nella directory radice dell'applicazione o in una delle relative sottocartelle.

Registrare l'assembly in un modulo Web dell'applicazione ASP.NET

In un ambiente di programmazione .NET aprire la finestra di origine Form.aspx e aggiungere il tag seguente all'inizio del codice:

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

Nel codice precedente:

• Custom è un alias associato a uno spazio dei nomi.
• CustomControlNamespace è uno spazio dei nomi in cui sono racchiuse le classi di un assembly.
• CustomControl è il nome del file di assembly senza estensione (.dll).

Nel codice modificare questi parametri in nomi appropriati per l'assembly.

A questo momento l'assembly viene registrato in un Web Form. È possibile usare questo assembly registrato nel codice ASP.NET con i nomi scelti. Ad esempio, il tag può essere:

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

Nel tag precedente è Custom il nome scelto per lo spazio dei nomi dell'assembly, CustomControl è il nome del controllo server personalizzato e parameter 1parameter2 sono proprietà di controllo facoltative che variano in base al codice effettivo.