Gewusst wie: Hinzufügen eines Verweises auf .NET- oder COM-Komponenten in einer Website

Artikel
10/22/2014

Aktualisiert: November 2007

Sie können auf .NET-Komponenten verweisen, die sich im globalen Assemblycache (GAC) befinden, sowie auf COM-Komponenten, die auf Ihrem Computer registriert sind. Sie können auch auf Komponenten verweisen, die sich zwar auf der Festplatte, aber nicht im GAC befinden. Durch das Verweisen auf eine Komponente wird die Komponente verfügbar und kann im Code verwendet werden.

Hinweis:
Wenn Sie eine Anwendung bereitstellen, die einen Verweis auf eine im GAC registrierte benutzerdefinierte Komponente enthält, wird die Komponente nicht mit der Anwendung bereitgestellt. In früheren Versionen von Visual Studio .NET konnten Sie die Option Lokale Kopie für einen Verweis aktivieren und damit sicherstellen, dass die Assembly bereitgestellt wird. In ASP.NET 2.0 müssen Sie eine Assembly, die mit der Anwendung bereitgestellt werden soll, dem Ordner Bin der Anwendung manuell hinzufügen. Dadurch wird das Risiko reduziert, dass Sie benutzerdefinierten Code, mit dem Sie nicht vertraut sind, ungewollt veröffentlichen. Weitere Informationen finden Sie unter Arbeiten mit Assemblys und dem globalen Assemblychache und unter Bereitstellung und der globale Assemblycache.

Wenn Sie eine Anwendung bereitstellen, die einen Verweis auf eine im GAC registrierte benutzerdefinierte Komponente enthält, wird die Komponente nicht mit der Anwendung bereitgestellt. In früheren Versionen von Visual Studio .NET konnten Sie die Option Lokale Kopie für einen Verweis aktivieren und damit sicherstellen, dass die Assembly bereitgestellt wird. In ASP.NET 2.0 müssen Sie eine Assembly, die mit der Anwendung bereitgestellt werden soll, dem Ordner Bin der Anwendung manuell hinzufügen. Dadurch wird das Risiko reduziert, dass Sie benutzerdefinierten Code, mit dem Sie nicht vertraut sind, ungewollt veröffentlichen. Weitere Informationen finden Sie unter Arbeiten mit Assemblys und dem globalen Assemblychache und unter Bereitstellung und der globale Assemblycache.

So fügen Sie Verweise auf registrierte COM-Komponenten hinzu

Wählen Sie im Menü Website die Option Verweis hinzufügen, und klicken Sie dann auf die Registerkarte COM.
Wählen Sie in der Liste der COM-Komponenten die gewünschte Komponente aus, und klicken Sie dann auf OK.

Visual Basic erstellt automatisch eine Interop-Assembly. Dabei handelt es sich um eine spezialisierte .NET-Assembly, die Metadaten zur Definition von COM-Typen enthält und es .NET-Compilern ermöglicht, Aufrufe von COM-Objekten aufzulösen.

Falls Sie die gewünschte Komponente nicht finden, klicken Sie auf die Registerkarte Durchsuchen, und durchsuchen Sie die Festplatte nach der Komponentendatei.

So fügen Sie Verweise auf .NET-Komponenten hinzu, die bereits mit .NET Framework registriert sind

Wählen Sie im Menü Website die Option Verweis hinzufügen, und klicken Sie dann im Dialogfeld auf die Registerkarte .NET.
Wählen Sie in der Liste der .NET-Komponenten die gewünschte Komponente aus, und klicken Sie auf OK.

Falls Sie die gewünschte Komponente nicht finden, klicken Sie auf die Registerkarte Durchsuchen, und durchsuchen Sie die Festplatte nach der Assemblydatei.

Verweise auf Komponenten

Nachdem Sie im Projekt einen Verweis auf eine Komponente hinzugefügt haben, können Sie die Komponente im Code verwenden.

So verwenden Sie eine Komponente, auf die verwiesen wird

Fügen Sie am Anfang der Klasse oder des Moduls eine Imports-Anweisung (Visual Basic) oder eine using-Anweisung (C#) ein, die den Namespace angibt, auf den verwiesen wird. Weitere Informationen hierzu finden Sie unter Imports-Anweisung (.NET-Namespace und Typ) oder unter using-Anweisung (C#-Referenz).

Danach können Sie die nicht vollqualifizierten Membernamen (ohne vorangestellten Namespacenamen) verwenden. Wenn Sie beispielsweise einen Verweis auf den System.Web-Namespace hinzufügen und eine Imports-Anweisung (Visual Basic) bzw. eine using-Anweisung (C#) für den System.Web.UI.WebControls-Namespace einfügen, können Sie auf die SiteMapNodeItem-Klasse verweisen, ohne deren vollqualifizierten Namen zu verwenden, wie im folgenden Beispiel:

[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);
}
```
Wenn Sie für den System.Web.UI.WebControls-Namespace keine Import-Anweisung (Visual Basic .NET) bzw. using-Anweisung (C#) verwenden, verweisen Sie weiterhin auf die SiteMapNodeItem-Klasse, müssen dafür aber deren vollqualifizierten Namen verwenden, wie im folgenden Beispiel:

[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);
}
```

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen oder Entfernen von Verweisen in Visual Studio (Visual Basic)

Gewusst wie: Verweisen auf COM-Objekte aus Visual Basic

Weitere Ressourcen

COM-Interop

Freigeben über