Comment : ajouter une référence à un composant .NET ou COM dans un site Web

Article
10/22/2014

Mise à jour : novembre 2007

Vous pouvez référencer des composants .NET qui se trouvent dans le Global Assembly Cache (GAC) ou des composants COM enregistrés sur votre ordinateur. Vous pouvez également référencer des composants qui se situent sur votre disque dur, mais pas dans le GAC. Lorsqu'un composant est référencé, il peut alors être utilisé dans votre code.

Remarque :
Si vous déployez une application qui contient une référence à un composant personnalisé enregistré dans le GAC, le composant ne sera pas déployé avec l'application. Dans les versions antérieures de Visual Studio .NET, vous pouviez définir la propriété Copie locale pour une référence, ce qui garantissait le déploiement de l'assembly. Dans ASP.NET 2.0, vous devez ajouter manuellement l'assembly au dossier Bin de l'application pour déployer un assembly avec votre application. Cela réduit le risque de publication d'un code personnalisé que vous ne connaissez pas bien. Pour plus d'informations, consultez Utilisation d'assemblys et du Global Assembly Cache et Déploiement et dossier Global Assembly Cache.

Si vous déployez une application qui contient une référence à un composant personnalisé enregistré dans le GAC, le composant ne sera pas déployé avec l'application. Dans les versions antérieures de Visual Studio .NET, vous pouviez définir la propriété Copie locale pour une référence, ce qui garantissait le déploiement de l'assembly. Dans ASP.NET 2.0, vous devez ajouter manuellement l'assembly au dossier Bin de l'application pour déployer un assembly avec votre application. Cela réduit le risque de publication d'un code personnalisé que vous ne connaissez pas bien. Pour plus d'informations, consultez Utilisation d'assemblys et du Global Assembly Cache et Déploiement et dossier Global Assembly Cache.

Pour ajouter des références aux composants COM enregistrés

Dans le menu Site Web, sélectionnez Ajouter une référence, puis cliquez sur l'onglet COM.
Dans la liste de composants COM, sélectionnez le composant à utiliser, puis cliquez sur OK.

Visual Basic crée automatiquement un assembly d'interopérabilité ; il s'agit d'un assembly .NET spécialisé qui contient les métadonnées pour définir des types COM et qui permet aux compilateurs .NET de résoudre des appels aux objets COM.

Si vous ne voyez pas le composant voulu, cliquez sur l'onglet Parcourir et recherchez le fichier du composant sur votre disque dur.

Pour ajouter des références aux composants .NET qui sont déjà enregistrés avec le .NET Framework

Dans le menu Site Web, sélectionnez Ajouter une référence, puis cliquez sur l'onglet .NET dans la boîte de dialogue.
Dans la liste de composants .NET, sélectionnez le composant à utiliser, puis cliquez sur OK.

Si vous ne voyez pas le composant voulu, cliquez sur l'onglet Parcourir et recherchez le fichier d'assembly sur votre disque dur.

Référencement de composants

Après avoir ajouté une référence à un composant dans votre projet, vous pouvez l'utiliser dans votre code.

Pour utiliser un composant référencé

Ajoutez une instruction Imports (Visual Basic) ou une instruction using (C#) en haut de la classe ou du module qui identifie l'espace de noms à référencer. Pour plus d'informations, consultez Imports, instruction (espace de noms et type .NET) ou using, instruction (Référence C#).

Vous pouvez ensuite utiliser des noms de membres sans qualifier complètement le nom (le nom du membre peut avoir comme préfixe le nom d'espace de noms). Par exemple, si vous ajoutez une référence à l'espace de noms System.Web et que vous incluez une instruction Imports (Visual Basic) ou une instruction using (C#) pour l'espace de noms System.Web.UI.WebControls, vous pouvez référencer la classe SiteMapNodeItem sans utiliser son nom qualifié complet, comme dans l'exemple suivant :

[Visual Basic]
```
Imports System.Web.UI.WebControls
Public Class SampleClass
    Dim smni As SiteMapNodeItem = _
        New SiteMapNodeItem(0, SiteMapNodeItemType.Parent)
End Class
```
```
using System.Web.UI.WebControls;
public class SampleClass
{
    SiteMapNodeItem smni = new 
        SiteMapNodeItem(0, SiteMapNodeItemType.Parent);
}
```
Si vous n'utilisez pas d'instruction Import Visual Basic .NET ni d'instruction using C# pour l'espace de noms System.Web.UI.WebControls, vous pouvez toujours référencer la classe SiteMapNodeItem, mais vous devez utiliser son nom qualifié complet, comme dans l'exemple ci-dessous.

[Visual Basic]
```
Public Class SampleClass
    Dim smni As System.Web.UI.WebControls.SiteMapNodeItem = _
        New System.Web.UI.WebControls.SiteMapNodeItem(0, _
        System.Web.UI.WebControls.SiteMapNodeItemType.Parent)
End Class
```
```
public class SampleClass
{
    System.Web.UI.WebControls.SiteMapNodeItem smni = 
        new System.Web.UI.WebControls.SiteMapNodeItem(0, 
        System.Web.UI.WebControls.SiteMapNodeItemType.Parent);
}
```

Voir aussi

Tâches

Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)

Comment : référencer les objets COM à partir de Visual Basic

Autres ressources

COM Interop