References.AddActiveX (Método)

Artigo
06/30/2009

Adiciona uma referência para uma biblioteca de tipos ActiveX.

Namespace: VSLangProj
Assembly: VSLangProj (em vslangproj.dll)

Sintaxe

'Declaração
'Uso

Parâmetros

bstrTypeLibGuid
Necessário. A biblioteca de tipos identificador globalmente exclusivo (GUID), expresso como uma seqüência.

lMajorVer
Opcional. O número da versão primária. Se omitido, 0 será usado.

lMinorVer
Opcional. O número de versão secundária. Se omitido, 0 será usado.

lLocaleId
Identificação de localidade opcional. Para obter mais informações, consulte LocaleID.

bstrWrapperTool
A ferramenta wrapper a ser usada ao gerar um wrapper do conjunto para a biblioteca de tipos. Os valores com suporte são descritos na tabela a seguir.

Value (Valor)	Resultado
`"tlbimp"`	O sistema do projeto gera um wrapper genérica adequada para acessar propriedades e métodos do objeto COM.
`"aximp"`	O sistema do projeto gera um wrapper que formulários Windows usa para hospedagem ActiveX.
(`""` vazio seqüência)	O sistema do projeto verifica se existe um conjunto de interoperabilidade primária para a biblioteca tipo especificado. Se encontrado, esse conjunto é usado como o wrapper para métodos e propriedades do objeto com o. Se não encontrado, o comportamento é o mesmo que se `"tlbimp"` foram especificados.

Valor de retorno

Retorna um Reference objeto para o objeto de biblioteca ActiveX solicitado.

Comentários

O AddActiveX método adiciona referências a um projeto para o objeto especificado e as dependências listadas por objeto. Portanto, uma chamada para este método pode resultar em mais de uma referência está sendo adicionado à coleção References.

O formato válido para um GUID é " {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" Um método para determinar a GUID para um objeto ActiveX é para exibir o arquivo.ocx ou.tlb usando a ferramenta Oleview.exe distribuída com o Visual Studio.

Um erro é gerado se uma referência com a mesma identidade já estiver na coleção.

Se você receber um erro " Biblioteca não registrada " ao fazer referência um objeto COM válido, e é provável Due o fato de que você não estiver passando um valor de parâmetro válido lMajorVer para o AddActiveX método. Por padrão, AddActiveX usa um valor de 0 para tudo, exceto o GUID. Se a versão do objeto COM é, por exemplo, 1, a chamada falhará porque não há nenhuma versão registrado 0 da biblioteca de tipos. Por exemplo, ao chamar versão 1.0 do Windows Media Player

ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}")

produz o erro aforementioned, mas

ref = refColl.AddActiveX("{22D6F304-B0F6-11D0-94AB-0080C74C7E95}", 1)

funciona corretamente.

Esse método irá adicionar somente uma biblioteca de tipos registrados. Uma chamada é feita para QueryPathOfRegTypeLib, uma função API automação (anteriormente automação OLE), passando as informações fornecidas para o AddActiveX método.

Se o nome do objeto ActiveX for conhecido, o objeto pode ser adicionado usando o Add. O Add método não requer identificação GUID, versão, ou localidade.

Para remover uma referência, use o Remove.

Para obter mais informações sobre com wrappers de objeto, ActiveX hospedagem, e conjuntos de interoperabilidade primária, consulte Importador de Biblioteca de Tipos (TLBIMP.exe) e Importador Controle ActiveX de formulários do Windows (Aximp.exe).

Exemplo

' Macro Editor
' Add a reference to the ActiveX Data Objects Library, Version 2.5
Imports VSLangProj
Public Sub AddARef()
   Try
      Dim proj As VSLangProj.VSProject = _
         CType(DTE.Solution.Projects.Item(1).Object, _
         VSLangProj.VSProject)
      ' GUID for ActiveX Data Objects, version 2.5
      proj.References.AddActiveX( _
      "{00000205-0000-0010-8000-00AA006D2EA4}", 2, 5)
   Catch ex As System.Exception
      MsgBox("Cannot add that reference.")
   End Try
End Sub

Consulte também

Referência

References (Interface)
References (Membros)
VSLangProj (Namespace)

Compartilhar via