Partilhar via


References.Add (Método)

Adiciona uma nova referência para o projeto.

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

Sintaxe

'Declaração
'Uso

Parâmetros

  • bstrPath
    Necessário. O caminho de uma referência com ou .NET Framework.

    Este parâmetro pode levar três formas:

    • Um nome de objeto .NET Framework simples como " sistema ",.

    • Um nome de arquivo .NET Framework (arquivo.tlb,.dll ou.OCX).

    • Um arquivo de biblioteca COM (arquivo.tlb,.dll,.ocx, ou.exe). Para objetos COM, o caminho precisa incluir um nome caminho e arquivo completo, por exemplo, " D:\SomeApplication\SomeApp.dll ". Consulte restrições na seção " References com " abaixo no adicionando referências arquivos.exe com.

Valor de retorno

Retorna um Reference objeto.

Comentários

Um erro é gerado se não há nenhuma biblioteca tipo no arquivo indicado pelo parâmetro bstrPath, ou a referência não pode ser resolvida (consulte Resolução referência seção).

Este método não gera um erro se existir no projeto com o mesmo Identity, Culture uma referência, MinorVersionMajorVersion., BuildNumber e RevisionNumber Como a nova referência Condição que indicaria que a referência indicado pelo parâmetro bstrPath já foi adicionada ao projeto. Do ProjectItem em vez disso, para a referência correspondente já no projeto será retornada.

Se uma referência com o mesmo Identity ou Culture for encontrado no projeto, o método gera um erro. mas com diferença MajorVersion, MinorVersion, RevisionNumber, BuildNumber

Para remover uma referência, use o Remove.

Exemplo

' Macro Editor
Imports VSLangProj
Sub AddExample()
   ' This example assumes that the first project in the solution is 
   ' either a Visual Basic or C# project.
   Dim aVSProject As VSProject = _
      CType(DTE.Solution.Projects.Item(1).Object, VSProject)
        
   Dim refs As References = aVSProject.References
   ' Adds a reference to a compiled .NET project.
   refs.Add("C:\path\program.dll")
   ' Adds a reference to an installed ActiveX control.
   refs.Add("C:\WINNT\system32\msmask32.ocx")
   ' Adds a reference to System.dll as an example of adding a
   ' reference using just the simple name.
   refs.Add("System")
End Sub

Consulte também

Referência

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