Método References.AddActiveX

Artigo
08/01/2011

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: System.String
Required.Identificador global exclusivo a biblioteca de tipos (GUID), expressa como uma seqüência de caracteres.

lMajorVer
Tipo: System.Int32
Optional.O número de versão principal.Se omitido, 0 é usado.

lMinorVer
Tipo: System.Int32
Optional.O número de versão secundária.Se omitido, 0 é usado.

lLocaleId
Tipo: System.Int32
Identificação de localidade opcional.For more information, see LocaleID.

bstrWrapperTool
Tipo: System.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 os métodos e propriedades 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] "" (seqüência 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 o objeto para o objeto da biblioteca solicitada do ActiveX.

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 a 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 é exibir o arquivo. ocx ou. tlb, usando a ferramenta Oleview. exe distribuída com Visual Studio.

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

Se você receber uma "biblioteca não registrada" Erro ao fazer referência a um objeto COM válido, e em seguida, provavelmente 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, exceto o GUID. Se a versão do objeto COM, por exemplo, 1, a chamada falhará porque não há nenhuma versão registrada 0 typelib. Por exemplo, ao chamar a versão 1.0 do que o 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 de arquivo do objeto ActiveX é conhecido, o objeto pode ser adicionado usando o Add. O Add método não requer o GUID, versão ou a localidade de identificação.

Para remover uma referência, use o Remove.

Para obter mais informações sobre wrappers do objeto COM a hospedagem de ActiveX e assemblies de interoperabilidade primária, consulte Tlbimp. exe (importador da biblioteca) e Aximp. exe (Importador de controle de 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áveis.

Consulte também

Referência

References Interface

Namespace VSLangProj

Compartilhar via