Zarządzanie referencjami w projekcie
Przed napisaniem kodu względem składnika zewnętrznego lub połączonej usługi projekt musi najpierw zawierać odwołanie do niego. Odwołanie to zasadniczo wpis w pliku projektu, który zawiera informacje potrzebne programowi Visual Studio do zlokalizowania składnika lub usługi.
Sposób dodawania odwołania zależy od typu projektu dla kodu, nad którym pracujesz:
Jeśli w Eksploratorze rozwiązań zobaczysz węzeł Zależności , możesz użyć menu kontekstowego, klikając prawym przyciskiem myszy, aby wybrać opcję Dodaj odwołanie do projektu.
Jeśli zobaczysz węzeł References w eksploratorze rozwiązań, możesz użyć menu kontekstowego, klikając prawym przyciskiem myszy, aby wybrać Dodaj odwołanie.
Aby uzyskać więcej informacji, zobacz Jak dodać lub usunąć odwołania.
Możesz dodać odwołanie do następujących typów składników i usług:
Biblioteki klas lub zestawy platformy .NET
Aplikacje platformy uniwersalnej systemu Windows
Składniki MODELU COM
Inne komponenty lub biblioteki klas projektów w tym samym rozwiązaniu
Udostępnione projekty
Usługi sieci Web XML
Odwołania do aplikacji UWP
Platforma uniwersalna systemu Windows platformy uniwersalnej systemu Windows (UWP) udostępnia wspólną platformę aplikacji dla każdego urządzenia z systemem Windows. Aby dowiedzieć się, jak utworzyć aplikację platformy UWP, zobacz samouczek : Tworzenie pierwszej aplikacji platformy uniwersalnej systemu Windows w programie Visual Studio przy użyciu języka XAML i języka C#.
Referencje projektowe
Projekty platformy uniwersalnej systemu Windows (UWP) mogą tworzyć odwołania do innych projektów platformy UWP w rozwiązaniu lub w projektach lub plikach binarnych systemu Windows 8.1, pod warunkiem, że te projekty nie używają interfejsów API, które zostały przestarzałe w systemie Windows 10 i nowszych. Aby uzyskać więcej informacji, zobacz Przejście z Windows Runtime 8 na UWP.
Jeśli zdecydujesz się przeadresować projekty systemu Windows 8.1 do systemu Windows 10 lub nowszego, zobacz Port, migrowanie i uaktualnianie projektów Visual Studio.
Napiwek
Aby uzyskać informacje na temat tworzenia i tworzenia nowej aplikacji platformy UWP dla systemów Windows 10 i Windows 11, zobacz Wybierz wersję platformy UWP.
Odwołania do rozszerzeń SDK
Aplikacje platformy uniwersalnej systemu Windows (UWP) w języku Visual Basic, C#, C++ i JavaScript mogą odwoływać się do zestawów SDK rozszerzeń przeznaczonych dla systemu Windows 8.1, o ile te zestawy SDK rozszerzeń nie korzystają z interfejsów API przestarzałych w systemie Windows 10 i nowszych wersjach. Sprawdź witrynę dostawcy zestawu SDK rozszerzeń, aby dowiedzieć się, czy można do niej odwoływać się przez aplikacje platformy UWP.
Jeśli ustalisz, że zestaw SDK rozszerzenia, do którego odwołuje się aplikacja, nie jest obsługiwany, należy wykonać następujące czynności:
Przyjrzyj się nazwie projektu, który powoduje błąd. Platforma docelowa projektu jest podana w nawiasach obok nazwy projektu. Na przykład MyProjectName (Windows 8.1) oznacza, że projekt MyProjectName jest przeznaczony dla wersję platformy Windows 8.1.
Przejdź do witryny dostawcy, który jest właścicielem nieobsługiwanego zestawu SDK rozszerzenia, a następnie zainstaluj wersję zestawu SDK rozszerzenia z zależnościami zgodnymi z wersją platformy docelowej projektu.
Notatka
Jednym ze sposobów ustalenia, czy zestaw SDK rozszerzenia ma zależności od innych zestawów SDK rozszerzeń, jest sprawdzenie w Reference Manager. Uruchom ponownie program Visual Studio, utwórz nowy projekt aplikacji platformy UWP w języku C#, a następnie kliknij prawym przyciskiem myszy projekt i wybierz pozycję Dodaj odwołanie. Przejdź do karty Windows, a następnie do podkarty Rozszerzenia i wybierz SDK rozszerzeń. Przyjrzyj się okienku po prawej stronie w menedżerze odwołań . Jeśli ma zależności, zostaną tam wyświetlone.
Ważny
Jeśli projekt jest przeznaczony dla systemu Windows 10, a zestaw SDK rozszerzenia zainstalowany w poprzednim kroku ma zależność od pakietu uruchomieniowego Programu Microsoft Visual C++, wersja pakietu uruchomieniowego Programu Microsoft Visual C++ zgodnego z systemem Windows 10 to wersja 14.0 i jest zainstalowana w programie Visual Studio.
Jeśli zestaw SDK rozszerzenia zainstalowany w poprzednim kroku ma zależności od innych zestawów SDK rozszerzeń, przejdź do witryn dostawców, którzy są właścicielami zależności, a następnie zainstaluj wersje tych zależności, które są zgodne z wersją platformy docelowej projektu.
Uruchom ponownie program Visual Studio i otwórz aplikację.
Kliknij prawym przyciskiem myszy węzeł References lub Dependencies w projekcie, który spowodował błąd, a następnie wybierz pozycję Dodaj odwołanie.
Wybierz kartę Windows, a następnie podkartę Extensions, odznacz pola wyboru dla starych SDK rozszerzeń, a następnie zaznacz pola wyboru dla nowych SDK rozszerzeń. Wybierz pozycję OK.
Dodaj odwołanie w czasie projektowania
Po utworzeniu odwołania do zestawu w projekcie program Visual Studio wyszukuje zestaw w następujących lokalizacjach:
Bieżący katalog projektu. (Te zespoły można znaleźć przy użyciu karty Przeglądaj).
Inne katalogi projektów w tym samym rozwiązaniu. (Możesz znaleźć te zgromadzenia na karcie Projekty).
Uwaga
- Wszystkie projekty zawierają dorozumiane odwołanie do mscorlib.
- Wszystkie projekty zawierają dorozumiane odwołanie do
System.Core, nawet jeśliSystem.Corezostanie usunięty z listy odwołań. - Projekty języka Visual Basic zawierają dorozumiane odwołanie do Microsoft.VisualBasic.
Odwołania do składników udostępnionych w czasie uruchomienia
W czasie wykonywania składniki muszą znajdować się w ścieżce wyjściowej projektu lub w globalnej pamięci podręcznej zestawów (GAC). Jeśli projekt zawiera odwołanie do obiektu, który nie znajduje się w jednej z tych lokalizacji, należy skopiować odwołanie do ścieżki wyjściowej projektu podczas kompilowania projektu. Właściwość CopyLocal wskazuje, czy ta kopia musi zostać wykonana. Jeśli wartość to True, odwołanie jest kopiowane do katalogu projektu podczas kompilowania projektu. Jeśli wartość to false, odwołanie nie zostanie skopiowane.
Jeśli wdrożysz aplikację zawierającą odwołanie do składnika niestandardowego zarejestrowanego w funkcji GAC, składnik nie zostanie wdrożony z aplikacją, niezależnie od ustawienia CopyLocal. We wcześniejszych wersjach programu Visual Studio można było ustawić właściwość CopyLocal na referencji, aby upewnić się, że zestaw został rozmieszczony. Teraz należy ręcznie dodać zestaw do folderu \Bin. Ta akcja powoduje, że cały kod niestandardowy jest dokładnie sprawdzany, co zmniejsza ryzyko publikowania niestandardowego kodu, z którym nie jesteś zaznajomiony.
Domyślnie właściwość CopyLocal jest ustawiona na wartość False, jeśli zestaw lub składnik znajduje się w globalnej pamięci podręcznej zestawów lub jest składnikiem struktury. W przeciwnym razie wartość jest ustawiona na wartość True. Odwołania do projektu są zawsze ustawione na true.
Odwołanie do projektu lub zestawu przeznaczonego dla innej wersji platformy .NET
Można tworzyć aplikacje odwołujące się do projektów lub zestawów przeznaczonych dla innej wersji platformy .NET. Można na przykład utworzyć aplikację przeznaczoną dla programu .NET Framework 4.6, która odwołuje się do zestawu przeznaczonego dla platformy .NET Framework 4.5. Jeśli tworzysz projekt przeznaczony dla starszej wersji platformy .NET, nie można ustawić odwołania w tym projekcie do projektu lub zestawu, który jest przeznaczony dla nowszej wersji.
Aby uzyskać więcej informacji, zobacz przegląd ukierunkowania platformy Framework.
Odwołania do projektu
Odwołania do projektu to odwołania do projektów, które zawierają zestawy; odwołania do projektu są dodawane przy użyciu karty Projects okna dialogowego Menedżer odwołań. Program Visual Studio może znaleźć zestaw, gdy zostanie podana ścieżka do projektu.
Jeśli masz projekt tworzący zestaw, należy odwołać się do projektu i nie używać odwołania do pliku. Zaletą odwołania do projektu jest utworzenie zależności między projektami w systemie kompilacji. Projekt zależny jest kompilowany, jeśli został zmieniony od czasu ostatniej kompilacji projektu odwołującego się. Odwołanie do pliku nie tworzy zależności kompilacji, więc można utworzyć projekt odwołujący się bez kompilowania projektu zależnego, a odwołanie może stać się przestarzałe. (Oznacza to, że projekt może odwoływać się do wcześniej utworzonej wersji projektu). Może to spowodować, że w katalogu bin wymagane jest kilka wersji pojedynczej biblioteki DLL, co nie jest możliwe. W przypadku wystąpienia tego konfliktu zostanie wyświetlony komunikat, taki jak "Ostrzeżenie: zależność 'file' w projekcie 'project' nie może zostać skopiowana do katalogu uruchamiania, ponieważ nadpisze odwołanie 'file'. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z uszkodzonymi odwołaniami oraz Jak: tworzenie i usuwanie zależności projektu.
Notatka
Odwołanie do pliku zamiast odwołania do projektu jest tworzone, jeśli docelowa wersja programu .NET Framework jednego projektu to wersja 4.5, a docelowa wersja drugiego projektu to wersja 2, 3, 3.5 lub 4.0.
Odwołania do udostępnionego projektu
W przeciwieństwie do większości innych typów projektów udostępniony projekt nie ma żadnych danych wyjściowych binarnych. Zamiast tego kod jest kompilowany w każdym projekcie, który się do niego odwołuje. Udostępnione projekty umożliwiają pisanie wspólnego kodu, do którego odwołuje się wiele różnych projektów aplikacji. Kod jest kompilowany w ramach każdego projektu referencyjnego i może zawierać dyrektywy kompilatora, aby ułatwić włączenie funkcji specyficznych dla platformy do wspólnej bazy kodu. Dodaj odwołanie do udostępnionego projektu na karcie Udostępnione projekty w oknie dialogowym Menedżera odwołań.
Odwołania do plików
Odwołania do plików są bezpośrednimi odwołaniami do zestawów poza kontekstem projektu programu Visual Studio. Można je utworzyć przy użyciu karty Przeglądaj okna dialogowego Menadżer odwołań. Użyj odwołania do pliku, gdy masz tylko zestaw lub składnik, a nie projekt, który tworzy go jako dane wyjściowe.