Cómo: Agregar una referencia a un componente .NET o COM en un sitio Web

Artículo
10/22/2014

Actualización: noviembre 2007

Se puede hacer referencia a componentes .NET que se encuentran en la caché de ensamblados global (GAC) o a los componentes COM registrados en el equipo. También se puede hacer referencia a componentes ubicados en el disco duro pero no en la GAC. Cuando se hace referencia a un componente, queda disponible para su utilización en el código.

Nota:
Si se implementa una aplicación que contenga una referencia a un componente personalizado registrado en la GAC, el componente no se implementará con la aplicación. En versiones anteriores de Visual Studio.NET, se podía establecer la propiedad Copia local para obtener una referencia, lo que garantizaba la implementación del ensamblado. En ASP.NET 2.0, para implementar un ensamblado con la aplicación, se debe agregar manualmente el ensamblado a la carpeta Bin de la aplicación. De este modo se reduce el riesgo de publicar código personalizado con el que no se esté familiarizado. Para obtener más información, vea Trabajar con ensamblados y la memoria Caché de ensamblados global y Implementación y la Caché de ensamblados global.

Si se implementa una aplicación que contenga una referencia a un componente personalizado registrado en la GAC, el componente no se implementará con la aplicación. En versiones anteriores de Visual Studio.NET, se podía establecer la propiedad Copia local para obtener una referencia, lo que garantizaba la implementación del ensamblado. En ASP.NET 2.0, para implementar un ensamblado con la aplicación, se debe agregar manualmente el ensamblado a la carpeta Bin de la aplicación. De este modo se reduce el riesgo de publicar código personalizado con el que no se esté familiarizado. Para obtener más información, vea Trabajar con ensamblados y la memoria Caché de ensamblados global y Implementación y la Caché de ensamblados global.

Para agregar las referencias a componentes COM registrados

En el menú Sitio Web, haga clic en Agregar referencia y, a continuación, elija la ficha COM.
Seleccione el componente que quiere utilizar de la lista de componentes COM y a continuación, haga clic en Aceptar.

Visual Basic crea automáticamente un ensamblado de interoperabilidad, que es un ensamblado .NET especializado que contiene metadatos para definir tipos COM y que permite a los compiladores de .NET resolver llamadas a objetos COM.

Si no ve el componente deseado, haga clic en la ficha Examinar y busque el archivo de componentes en la unidad de disco duro.

Para agregar referencias a componentes .NET que ya están registrados con .NET Framework

En el menú Sitio Web, haga clic en Agregar referencia y, a continuación, elija la ficha .NET en el cuadro de diálogo.
Seleccione el componente que desee utilizar de la lista de componentes .NET y, a continuación, haga clic en Aceptar.

Si no ve el componente deseado, haga clic en la ficha Examinar y busque el archivo de ensamblado en la unidad de disco duro.

Hacer referencia a componentes

Después de agregar una referencia a un componente en el proyecto, se puede utilizar en el código.

Para utilizar un componente al que se hace referencia

Agregue una instrucción Imports (Visual Basic) o using (C#) en la parte superior de la clase o módulo que identifica el espacio de nombres al que se va a hacer referencia. Para obtener más información, vea Instrucción Imports (Tipo y espacio de nombres de .NET) o using (Instrucción, Referencia de C#).

A continuación, puede utilizar nombres de miembro que no sean completos (colocando como prefijo del nombre de miembro el nombre del espacio de nombres). Por ejemplo, si agrega una referencia al espacio de nombres System.Web e incluye una instrucción Imports (Visual Basic) o using (C#) para el espacio de nombres System.Web.UI.WebControls, puede hacer referencia a la clase SiteMapNodeItem sin utilizar el nombre completo, como en el ejemplo siguiente:

[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 no se utiliza una instrucción Import de Visual Basic .NET o la instrucción using de C# para el espacio de nombres System.Web.UI.WebControls, se puede seguir haciendo referencia a la clase SiteMapNodeItem, pero debe utilizarse el nombre completo, como en el ejemplo siguiente.

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

Vea también

Tareas

Cómo: Agregar o quitar referencias en Visual Studio (Visual Basic)

Cómo: Hacer referencia a objetos COM desde Visual Basic

Otros recursos

Interoperabilidad COM

Compartir a través de