Como: Adicionar uma referência a um componente COM ou .NET em um site da Web

Artigo
10/15/2014

Você pode referenciar componentes .NET que estão no cache global de assemblies (GAC) ou componentes COM registrados no seu computador.Você pode também referenciar componentes que estão localizados na sua unidade de disco rígido mas não no GAC.A referência de um componente o torna disponível para uso em seu código.

Observação:
Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC, o componente não será implantado com o aplicativo.Em versões anteriores do Visual Studio.NET, você poderia conjunto a Copiar localpropriedade para obter uma referência, que garantia que o assembly seria implantado.No ASP.NET 2.0, para implantar qualquer assembly com seu aplicativo, você deve adicionar manualmente o assembly no aplicativo da pasta Bin.Isso reduz o risco de publicação de código personalizado com o qual você não estiver familiarizado.Para obter mais informações, consulte Trabalhando com Assemblies e o Cache Global de Assemblies e Implantação e Assembly cache global de.

Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC, o componente não será implantado com o aplicativo.Em versões anteriores do Visual Studio.NET, você poderia conjunto a Copiar localpropriedade para obter uma referência, que garantia que o assembly seria implantado.No ASP.NET 2.0, para implantar qualquer assembly com seu aplicativo, você deve adicionar manualmente o assembly no aplicativo da pasta Bin.Isso reduz o risco de publicação de código personalizado com o qual você não estiver familiarizado.Para obter mais informações, consulte Trabalhando com Assemblies e o Cache Global de Assemblies e Implantação e Assembly cache global de.

Para adicionar referências a componentes COM registrados.

No menu Website, escolha Add Reference e, em seguida, clique na guia COM.
Selecione o componente que você deseja usar a partir da lista de componentes COM e clique em OK.

Visual Basic automaticamente cria um assembly interoperacional, que é um assembly especializado em .NET que contém meta-dados para definir tipos COM e que habilita compiladores .NET para resolver chamadas a objetos COM.

Se você não vir o componente que deseja, clique na guia Browse e procure o arquivo de componente em sua unidade de disco rígido.

Para adicionar referências a componentes .NET que já estão registrados com o Framework .NET

No menu Website, escolha Add Reference e, em seguida, clique na guia .NET na caixa de diálogo
Selecione o componente que você deseja usar a partir da lista de componentes .NET e clique em OK.

Se você não vir o componente que deseja, clique na guia Browse e procure o arquivo assembly em sua unidade de disco rígido.

Referenciando Componentes

Depois que você adiciona uma referência a um componente em seu projeto, pode usá-lo em seu código.

Para usar um componente referenciado

Adicione uma declaração (Visual Basic) Imports ou uma declaração (C#) using ao topo da classe ou módulo que identifica o namespace como referência.Para obter mais informações, consulte Declaração Imports (Tipo e Namespace .NET) ou Usando Instrução (Referência C#).

Você pode usar nomes de membros sem qualificar totalmente o nome (prefixando o nome do membro com o nome namespace).Por exemplo, se você adicionar uma referência ao namespace System.Web e você incluir uma declaração (Visual Basic) Imports ou declaração (C#) using para o namespace System.Web.UI.WebControls, você pode referenciar a classe SiteMapNodeItem sem utilizar seu nome completo qualificado, como no exemplo seguinte:

[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);
}
```
Se você não utilizar uma declaração Visual Basic .NET Import ou declaração C# using para o namespace System.Web.UI.WebControls, você ainda referencia a classe SiteMapNodeItem, mas você deve utilizar seu nome completo qualificado, como no exemplo seguinte:

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

Consulte também

Tarefas

Como: Adicionar ou remover referências no Visual Studio (Visual Basic)

Como: Objetos de referência COM do Visual Basic

Outros recursos

Interoperabilidade COM

Compartilhar via