References.Add – metoda

Článek
05/16/2015

Přidá nový odkaz na projekt.

Obor názvů: VSLangProj
Sestavení: VSLangProj (v VSLangProj.dll)

Syntaxe

'Deklarace
Function Add ( _
    bstrPath As String _
) As Reference

Reference Add(
    string bstrPath
)

Reference^ Add(
    [InAttribute] String^ bstrPath
)

abstract Add : 
        bstrPath:string -> Reference

function Add(
    bstrPath : String
) : Reference

Parametry

bstrPath
Typ: String

Povinné.Cesta COM nebo.NET Framework odkaz.

Tento parametr může mít tři formy:

Jednoduché.NET Framework název objektu, například "System".

A.NET Framework název souboru (soubor .tlb, DLL nebo OCX).

Soubor knihovny COM (soubor .tlb, DLL, OCX nebo exe).Objekty COM musí cesta obsahovat úplnou cestu a název, například "D:\SomeApplication\SomeApp.dll".Přidání odkazuje soubor EXE modelu COM naleznete v tématu omezení v části "COM odkazy" níže.

Vrácená hodnota

Typ: VSLangProj.Reference
Vrátí Reference objektu.

Poznámky

Generována chyba, pokud jsou v souboru označeny žádné knihovny typu bstrPath parametr nebo odkaz nelze přeložit (viz oddíl rozlišení odkaz).

Tato metoda negeneruje chybu, pokud existuje odkaz v projektu se stejným Identity, Culture, MajorVersion, MinorVersion, BuildNumber, a RevisionNumber jako nový odkaz.Tato podmínka naznačují, že odkaz označen bstrPath parametr již byl přidán do projektu.Místo toho ProjectItem pro odpovídající odkaz již v projektu je vrácena.

Pokud odkaz se stejným Identity ale rozdílné MajorVersion, MinorVersion, BuildNumber, RevisionNumber, nebo Culture se nachází v projektu, metoda generuje chybu.

Chcete-li odebrat odkaz, použijte Remove.

Odkazy modelu COM.

Tato metoda vrátí Reference pro první knihovnu typů v souboru Odkazovaný objekt.

Tato metoda přidá všechny objekty v souboru typu knihovny a závislosti těchto objektů.Proto může způsobit více než jeden odkaz do jediné volání této metody References kolekce.

Soubory EXE COM mohou být přidány, odkazy, pokud obsahují knihovny typů.V takovém případě jsou přidány odkazy na všechny knihovny registrovaný typ souboru EXE.

.NET Framework odkazy

Tato metoda vrátí Reference pro sestavení je odkaz na objekt.

Tyto odkazy nemají soubor typu knihovny, takže žádná závislá sestavení jsou přidány jako odkazy na projekt.

Pokud odkaz na sestavení s vloženými také typ knihovny, je přidán pouze odkaz na sestavení.

Odkazy na.NET Framework soubory exe jsou povoleny.

Referenční řešení

Při uložení souboru projektu cesty pro odkazy nebudou uloženy jako součást projektu.To umožňuje soubor projektu sdílet mezi počítači snadněji.Například System.dll může být uložena v C:\Bigfolder v počítači a a může být uložena v D:\Smallfolder v počítači B.Pro.NET Framework, odkazy, bude zachováno pouze odkaz na název sestavení.Takže pro System.dll, je trvalé "System".

Kompilátory přijímat pouze odkazy ve formě úplnou cestu a název souboru, například C:\Bigfolder\system.dll.Proto musí být některé jednotný způsob vyhledání sestavení v době návrhu.Sestavení je vyřešen, je-li úplnou cestu k sestavení může být umístěn.Přeložit cesta je úplná cesta k odkazu.Pokračováním systému například pokud System.dll nalezen v C:\Bigfolder, pak je vyřešen System.dll, jeho vyřešení cesty je C:\Bigfolder\System.dll.

Odkaz vyřešíte vývojové prostředí z referenční a hledá odkaz vytvoří vyhledávací název.Vyhledávací název je vytvořen tak, že obsahuje příponu DLL, protože název uloženého odkazu mohou nebo nemusí obsahovat příponu DLL.Dva odkazy, ReferenceOne a ReferenceTwo.dll, bude mít názvy ReferenceOne.dll a ReferenceTwo.dll, resp..

Vývojové prostředí hledá jméno v následujícím pořadí, zastavení, jakmile je nalezeno:

V hierarchii projektu.
V cestě pro vyhledávání odkazů, což je nastavení projektu.Další informace naleznete v tématu ReferencePath.
Výběr komponent v sadě adresářů používá při výčtu odkazy.Tato sada adresářů je uložen v registru během instalace.

Každý odkaz je vyřešen při načtení projektu.Rozlišení dochází také v nové při odkazu bstrPath parametr Add metoda je něco jiného než úplnou cestu.

Pokud odkaz nelze vyřešit, je generována chyba.Odkazy COM být vyřešen, protože je nutná úplná cesta bstrPath parametr.Pokud bstrPath je parametr.NET Framework název (například SomeObject) nebo.NET Framework souboru název bez cesty (například SomeObject.dll), pak je možné, že odkaz nemusí být vyřešeny, je generována chyba.

Příklady

' 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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

References Rozhraní

VSLangProj – obor názvů

Sdílet prostřednictvím