Inscrire un assembly dans un WebForm pour utiliser un contrôle personnalisé

  • Article

Cet article fournit des informations sur la création et l’inscription d’un assembly disponible dans un formulaire WebForm à utiliser avec ASP.NET contrôles serveur personnalisés.

              Version d’origine du produit : ASP.NET
Numéro de la base de connaissances d’origine : 321749

Exemples de propriétés d’assembly

Pour être représenté en tant que contrôle serveur personnalisé, l’assembly doit avoir une classe qui dérive directement ou indirectement de System.Web.UI.Control et vous devez placer la classe dans un espace de noms. Les exemples de cet article supposent que la classe est placée dans l’espace CustomControlNamespace de noms et que l’assembly a été correctement compilé dans un fichier nommé CustomControl.dll.

Rendre un assembly disponible pour ASP.NET application

Pour rendre un assembly disponible pour une application ASP.NET, vous devez placer le .dll de l’assembly dans le /bin dossier de l’application.

  1. Accédez au répertoire racine de l’application dans Windows Explorer.

    Pour connaître le dossier du projet d’application :

    1. Dans l’environnement .NET, sous le menu Affichage, sélectionnez Explorateur de solutions.
    2. Cliquez avec le bouton droit sur un élément de main projet dans Explorateur de solutions, puis sélectionnez Propriétés.
    3. Dans la boîte de dialogue Propriétés du projet , sélectionnez Propriétés communes , puis Général.

    Dans le volet d’arborescence, vous voyez la liste avec la propriété Dossier du projet . Il s’agit généralement du répertoire racine de l’application.

  2. Dans un dossier de projet d’application web, créez un dossier nommé bin s’il n’existe pas.

  3. Copiez ou déplacez la .dll de l’assembly dans ce dossier. Vous pouvez désormais utiliser le contrôle à partir de n’importe quelle page ASP.NET du répertoire racine de votre application (ou de l’un de ses sous-dossiers).

Inscrire l’assembly dans un formulaire web d’application ASP.NET

Dans un environnement de programmation .NET, ouvrez la fenêtre source Form.aspx et ajoutez la balise suivante en haut du code :

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

Dans le code ci-dessus :

  • Custom est un alias que vous associez à un espace de noms.
  • CustomControlNamespace est un espace de noms dans lequel les classes d’un assembly sont incluses.
  • CustomControl est le nom du fichier d’assembly sans extension (.dll).

Dans votre code, remplacez ces paramètres par les noms appropriés pour votre assembly.

L’assembly est maintenant inscrit dans un formulaire web. Vous pouvez utiliser cet assembly inscrit dans votre code ASP.NET avec les noms choisis. Par exemple, la balise peut être :

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

Dans la balise ci-dessus, Custom est le nom choisi pour l’espace de noms de l’assembly, CustomControl est le nom du contrôle serveur personnalisé et parameter 1 et sont parameter2 des propriétés de contrôle facultatives qui varient en fonction de votre code réel.