Metoda References.Add —

Artykuł
05/17/2015

Dodaje nowe odwołanie do projektu.

Przestrzeń nazw: VSLangProj
Zestaw: VSLangProj (w VSLangProj.dll)

Składnia

'Deklaracja
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

Wymagane.Ścieżka COM lub.NET Framework odniesienia.

Ten parametr może przyjąć trzy formy:

Prosta.Nazwa obiektu NET Framework, takich jak "System".

A.NET Framework nazwy pliku (plik .tlb, .dll lub .ocx).

Plik biblioteki COM (plik .tlb, .dll, .ocx lub .exe).Dla obiektów COM ścieżka musi zawierać pełną ścieżkę i nazwę pliku, takie jak "D:\SomeApplication\SomeApp.dll".Dodawanie odwołania do pliku exe COM Zobacz ograniczenia w sekcji "Materiały referencyjne COM" poniżej.

Wartość zwracana

Typ: VSLangProj.Reference
Zwraca Reference obiektu.

Uwagi

Zostanie wygenerowany błąd, jeśli brak bibliotek typów w pliku wskazane przez bstrPath parametr lub odwołanie nie może być rozpoznana (patrz sekcja rozdzielczość odniesienia).

Ta metoda nie generuje błąd, jeśli istnieje odwołanie w projekcie o tej samej Identity, Culture, MajorVersion, MinorVersion, BuildNumber, i RevisionNumber jako nowy punkt odniesienia.Ten warunek wskazywałyby, że odniesienia wskazany przez bstrPath parametr został już dodany do projektu.Zamiast tego ProjectItem dla pasujących odwołanie już w projekcie jest zwracany.

Jeśli odwołanie o tej samej Identity ale zróżnicowanych MajorVersion, MinorVersion, BuildNumber, RevisionNumber, lub Culture znajduje się w projekcie, metoda generuje błąd.

Aby usunąć odwołanie, użyj Remove.

Odwołania COM

Ta metoda zwraca Reference obiekt dla pierwszego biblioteki typów w pliku, którego dotyczy odwołanie.

Metoda ta dodaje wszystkie obiekty znalezione w pliku biblioteki typu oraz wszystkie zależności tych obiektów.W związku z tym, pojedyncze wywołanie tej metody może spowodować więcej niż jedno odwołanie do References kolekcji.

Pliki .exe COM mogą być dodane jako odniesienia, jeżeli zawierają one biblioteki typów.W takim przypadku dodaje się odwołania do wszystkich bibliotek zarejestrowany typ zawarte w pliku .exe.

.NET Framework odwołania

Ta metoda zwraca Reference obiektu zestawu jest odwołanie.

Te odwołania nie pliku biblioteki typów, więc nie zestawy zależne są dodawane jako odniesienia do projektu.

Jeśli odwołanie jest to zespół, który ma również osadzone biblioteki typów, zostanie dodany tylko odwołanie do zestawu.

Odniesienia do.NET Framework pliki exe są dozwolone.

Rozpoznawanie odwołania

Po zapisaniu pliku projektu ścieżek dla odwołania nie są zapisywane jako część projektu.Dzięki temu plik projektu być łatwiej udostępniane między komputerami.Na przykład plik System.dll może być przechowywany w C:\Bigfolder na komputerze A, i mogą być przechowywane w D:\Smallfolder na komputerze B.Dla.NET Framework odniesienia, nazwa zestawu odniesienia jest zachowywane.Tak aby plik System.dll, "System" jest zachowywane.

Kompilatory akceptować tylko odwołania w formularzu pełną ścieżkę i nazwę pliku, na przykład C:\Bigfolder\system.dll.Tak musi być spójny sposób lokalizowania zestawów w czasie projektowania.Zespół został rozwiązany, jeśli pełną ścieżkę do zgromadzenia może zostać zlokalizowany.Rozpoznać ścieżki jest pełną ścieżką do odwołania.Kontynuowanie przykład systemu, jeśli zostanie znaleziony plik System.dll, C:\Bigfolder, a następnie, gdy plik System.dll został rozwiązany, jego rozwiązane ścieżka jest C:\Bigfolder\System.dll.

Aby rozwiązać odwołanie, środowiska programistycznego tworzy Nazwa szukana z odniesienia i wyszukiwania dla odwołania.Nazwa szukana jest tworzony, tak by zawierał rozszerzenie .dll, ponieważ zapisana nazwa odwołanie może lub nie może zawierać rozszerzenie .dll.Dwa odniesienia, ReferenceOne i ReferenceTwo.dll, będzie mają nazwy ReferenceOne.dll i ReferenceTwo.dll, odpowiednio.

Środowisko programowania wyszukuje nazwy w następującej kolejności, zatrzymywanie, tak szybko, jak tylko zostanie znaleziony:

W hierarchii projektu.
W ścieżce wyszukiwania odwołania, który jest ustawienie na poziomie projektu.Aby uzyskać więcej informacji, zobacz ReferencePath.
Zestawu katalogów próbnika składnik używa podczas wyliczania odniesienia.Ten zestaw katalogów jest przechowywane w rejestrze podczas instalacji.

Każde odwołanie zostanie rozwiązany po załadowaniu projektu.Rozdzielczość występuje również na nowym odwołać, gdy bstrPath parametr Add metoda jest inny niż pełną ścieżkę.

Jeżeli odwołanie nie może być rozwiązany, zostanie wygenerowany błąd.Odwołania do modelu COM zawsze będą rozwiązywane, ponieważ pełną nazwę ścieżki jest wymagany w bstrPath parametru.Jeśli bstrPath jest parametr.NET Framework nazwy (na przykład SomeObject) lub.NET Framework pliku nazwę bez ścieżki (na przykład SomeObject.dll), a następnie jest możliwe, że odwołanie nie może być rozwiązane i zostanie wygenerowany błąd.

Przykłady

' 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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

References Interfejs

Przestrzeń nazw VSLangProj

Udostępnij za pośrednictwem