Método References.AddActiveX

Artigo
05/17/2015

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

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

Sintaxe

'Declaração
Function AddActiveX ( _
    bstrTypeLibGuid As String, _
    lMajorVer As Integer, _
    lMinorVer As Integer, _
    lLocaleId As Integer, _
    bstrWrapperTool As String _
) As Reference

Reference AddActiveX(
    string bstrTypeLibGuid,
    int lMajorVer,
    int lMinorVer,
    int lLocaleId,
    string bstrWrapperTool
)

Reference^ AddActiveX(
    [InAttribute] String^ bstrTypeLibGuid, 
    [InAttribute] int lMajorVer, 
    [InAttribute] int lMinorVer, 
    [InAttribute] int lLocaleId, 
    [InAttribute] String^ bstrWrapperTool
)

abstract AddActiveX : 
        bstrTypeLibGuid:string * 
        lMajorVer:int * 
        lMinorVer:int * 
        lLocaleId:int * 
        bstrWrapperTool:string -> Reference

function AddActiveX(
    bstrTypeLibGuid : String, 
    lMajorVer : int, 
    lMinorVer : int, 
    lLocaleId : int, 
    bstrWrapperTool : String
) : Reference

Parâmetros

bstrTypeLibGuid
Tipo: String

Obrigatório. Identificador global exclusivo a biblioteca de tipos (GUID), expressa como uma seqüência de caracteres.

lMajorVer
Tipo: Int32

Opcional. O número de versão principal. Se omitido, 0 é usado.

lMinorVer
Tipo: Int32

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

lLocaleId
Tipo: Int32

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

bstrWrapperTool
Tipo: String

A ferramenta wrapper a ser usada ao gerar um wrapper de assembly para a biblioteca de tipos. Os valores aceitos são descritos na tabela a seguir.

[1|1] Valor

[1|2] Resultado

[2|1] "tlbimp"

[2|2] O sistema de projeto gera um invólucro genérica adequado para acessar propriedades e métodos do objeto COM.

[3|1] "aximp"

[3|2] O sistema de projeto gera um invólucro que usa o Windows forms para hospedar de ActiveX.

[4|1] "" (cadeia de caracteres vazia)

[4|2] O sistema de projeto verifica se um assembly de interoperabilidade primária para a biblioteca de tipo especificado existe. Se encontrado, então esse assembly é usado como o wrapper para os métodos e propriedades do objeto COM. Se não encontrado, o comportamento é o mesmo como se "tlbimp" foram especificados.

Valor de retorno

Tipo: VSLangProj.Reference
Retorna um Reference objeto para o objeto de biblioteca ActiveX solicitado.

Comentários

O AddActiveX método adiciona as referências a um projeto para o objeto especificado e quaisquer dependências listadas pelo objeto. Portanto, uma chamada para esse método pode resultar em mais de uma referência que está sendo adicionada ao References coleção.

O formato válido para um GUID é "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}", onde x é um dígito hexadecimal (0,1,2,3,4,5,6,7,8,9, A, B, C, D, E, F). Um método para determinar o GUID para um objeto ActiveX é para exibir o arquivo. ocx ou. tlb, usando a ferramenta Oleview. exe distribuída com Visual Studio.

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

Se você recebe um erro "A biblioteca não registrada" ao fazer referência a um objeto COM válido, então é provável que, devido ao fato de que você não está passando um válido lMajorVer o valor do parâmetro para o AddActiveX método. Por padrão, AddActiveX usa um valor de 0 para tudo, o GUID. Se a versão do objeto COM, por exemplo, 1, a chamada falhará porque não há nenhuma versão registrada 0 do typelib. Por exemplo, ao chamar a versão 1.0 do Windows Media player

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

produz o erro mencionado anteriormente, mas

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

funciona corretamente.

Este método adiciona somente uma biblioteca de tipo registrado. É feita uma chamada para QueryPathOfRegTypeLib, uma função de API de automação (anteriormente automação OLE), passando as informações fornecidas a AddActiveX método.

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

Para remover uma referência, use o Remove.

Para obter mais informações sobre os invólucros de objeto COM, ActiveX que hospeda e assemblies de interoperabilidade primária, consulte Tlbimp.exe (Importador de Biblioteca de Tipos) e Aximp.exe (Importador de Controle ActiveX do Windows Forms).

Exemplos

' 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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

References Interface

Namespace VSLangProj

Partilhar via