Udostępnij za pośrednictwem

Zarządzanie odwołaniami w projekcie

  • Artykuł

Przed napisaniem kodu względem składnika zewnętrznego lub połączonej usługi projekt musi najpierw zawierać odwołanie do niego. Odwołanie jest zasadniczo wpisem w pliku projektu zawierającym informacje potrzebne do zlokalizowania składnika lub usługi w programie Visual Studio.

Sposób dodawania odwołania zależy od typu projektu dla kodu, nad którym pracujesz:

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 UWP

  • COM — Składniki

  • Inne zestawy lub biblioteki klas projektów w tym samym rozwiązaniu

  • Projekty udostępnione

  • Usługi sieci Web XML

Odwołania do aplikacji platformy UNIWERSALNEJ systemu Windows

Platforma uniwersalna 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 platforma uniwersalna systemu Windows w programie Visual Studio przy użyciu języka XAML i języka C#.

Odwołania projektu

platforma uniwersalna systemu Windows (UWP) projekty mogą tworzyć odwołania do innych projektów platformy UWP w rozwiązaniu lub do projektów lub plików 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 Przenoszenie z środowisko wykonawcze systemu Windows 8 do platformy UWP.

Jeśli zdecydujesz się ponownie przenieść projekty systemu Windows 8.1 do systemu Windows 10 lub nowszego, zobacz Przenoszenie, migrowanie i uaktualnianie projektów programu Visual Studio.

Napiwek

Aby uzyskać informacje na temat tworzenia i tworzenia nowej aplikacji platformy UWP dla systemów Windows 10 i Windows 11, zobacz Wybieranie wersji platformy UWP.

Odwołania do zestawu SDK rozszerzeń

Aplikacje visual Basic, C#, C++ i JavaScript platforma uniwersalna systemu Windows (UWP) mogą odwoływać się do zestawów SDK rozszerzeń przeznaczonych dla systemu Windows 8.1, o ile te zestawy SDK rozszerzeń nie używają interfejsów API przestarzałych w systemie Windows 10 lub nowszym. 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:

  1. Przyjrzyj się nazwie projektu, który powoduje błąd. Platforma docelowa projektu jest zanotowany w nawiasach obok nazwy projektu. Na przykład MyProjectName (Windows 8.1) oznacza, że projekt MyProjectName jest przeznaczony dla platformy w wersji Windows 8.1.

  2. 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.

    Uwaga

    Jednym ze sposobów ustalenia, czy zestaw SDK rozszerzenia ma zależności od innych zestawów SDK rozszerzeń, jest wyszukanie w Menedżerze odwołań. 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 polecenie Dodaj odwołanie. Przejdź do karty Windows , a następnie na karcie Podrzędne Rozszerzenia i wybierz zestaw SDK rozszerzenia. Przyjrzyj się okienku po prawej stronie w Menedżerze odwołań. Jeśli ma zależności, zostaną tam wyświetlone.

    Ważne

    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.

  3. 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.

  4. Uruchom ponownie program Visual Studio i otwórz aplikację.

  5. Kliknij prawym przyciskiem myszy węzeł Odwołania lub Zależności w projekcie, który spowodował błąd, a następnie wybierz pozycję Dodaj odwołanie.

  6. Wybierz kartę Windows , a następnie podtabę Rozszerzenia, usuń zaznaczenie pól wyboru dla starych zestawów SDK rozszerzeń, a następnie zaznacz pola wyboru dla nowych zestawów SDK rozszerzeń. Wybierz przycisk OK.

Dodawanie odwołania 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 zestawy można znaleźć przy użyciu elementu Karta Przeglądania .

  • Inne katalogi projektów w tym samym rozwiązaniu. (Te zestawy można znaleźć na stronie Karta Projekty ).

Uwaga

  • Wszystkie projekty zawierają dorozumiane odwołanie do biblioteki mscorlib.
  • Wszystkie projekty zawierają dorozumiane odwołanie do System.Coreelementu , nawet jeśli System.Core zostanie usunięte z listy odwołań.
  • Projekty języka Visual Basic zawierają dorozumiane odwołanie do Microsoft.VisualBasicelementu .

Odwołania do składników udostępnionych w czasie wykonywania

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ść ma wartość True, odwołanie jest kopiowane do katalogu projektu podczas kompilowania projektu. Jeśli wartość to Fałsz, 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 CopyLocal ustawienia. We wcześniejszych wersjach programu Visual Studio można ustawić CopyLocal właściwość w odwołaniu, aby upewnić się, że zestaw został wdrożony. Teraz należy ręcznie dodać zestaw do folderu \Bin. Ta akcja powoduje, że cały kod niestandardowy jest pod kontrolą, co zmniejsza ryzyko publikowania niestandardowego kodu, za pomocą którego nie znasz.

Domyślnie właściwość ma wartość False, CopyLocal 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 True. Odwołania do projektu są zawsze ustawione na wartość 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 Omówienie określania elementów docelowych platformy.

Odwołania do projektu

Odwołania do projektu to odwołania do projektów, które zawierają zestawy; Odwołania do projektu można dodawać przy użyciu karty Projekty 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ść "plik" w projekcie "project" nie może zostać skopiowana do katalogu uruchamiania, ponieważ zastąpi odwołanie "file". Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z uszkodzonymi odwołaniami i Instrukcje: tworzenie i usuwanie zależności projektu.

Uwaga

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 odwołującego się do projektu i może zawierać dyrektywy kompilatora, aby ułatwić włączenie funkcji specyficznych dla platformy do udostępnionej bazy kodu. Dodaj odwołanie do udostępnionego projektu na karcie Udostępnione projekty okna dialogowego Menedżer 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 Menedż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.

Powiązana zawartość