References.Add – metoda

Článek
08/11/2011

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: System.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).Cesta objektů COM musí obsahovat úplnou cestu a název, například "D:\SomeApplication\SomeApp.dll".Viz omezení odkazy"COM" část pod přidání COM odkazuje soubor EXE.

Vrácená hodnota

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

Poznámky

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

Tato metoda generuje chybu, pokud existuje odkaz v projektu se stejným Identity, Culture, MajorVersion, MinorVersion, BuildNumber, a RevisionNumber jako nový odkaz.Podmínky 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.

Odebrat odkaz pomocí Remove.

COM odkazy

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 jediné volání této metody může vést k více než jeden odkaz References kolekce.

COM soubory EXE, 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 objekt pro sestavení je odkaz.

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

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

Odkazy naNET 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 sdílet mezi počítači snadněji souboru projektu.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 odkazuje, trvala pouze referenční název sestavení.Tak pro System.dll "Systém" trvalé.

Kompilátory přijímat pouze odkazy ve formuláři ú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.Pokud mohou být umístěny úplnou cestu k sestavení sestavení vyřešen.Přeložit cesta je úplná cesta k odkazu.Pokud System.dll nalezen v C:\Bigfolder, pak je vyřešen System.dll pokračováním příklad systému, jeho vyřešení cesta je C:\Bigfolder\System.dll.

Vývojové prostředí vyřešit odkaz vytvoří z odkazu a odkaz vyhledá vyhledávací název.Vyhledávací název je vytvořen tak, že obsahuje příponu DLL, protože může nebo nemusí obsahovat příponu DLL název uloženého odkazu.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ž úplné cesty

Pokud odkaz nelze vyřešit, je generována chyba.Odkazy COM bude vždy vyřešen, protože je nutná úplná cesta bstrPath parametr.Pokud bstrPath parametr.NET Framework název (například SomeObject) nebo.NET Framework název bez cesty (například SomeObject.dll) souboru a pak je možné, že odkaz může být vyřešen a 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é

Odkaz

References Rozhraní

VSLangProj – obor názvů

Sdílet prostřednictvím