Zarządzanie odwołaniami projektu

Artykuł
06/10/2015

Zanim napiszesz kod w stosunku do składnika zewnętrznego Twój projekt musi zawierać odniesienie do tego składnika.Można zrobić odnośnik do następujących typów komponentów:

Odwołania aplikacji Windows Store
Biblioteki klas lub zestawy .NET Framework
Składniki COM
Inne zespoły lub biblioteki klas projektów w tym samym rozwiązaniu
Usługi sieci Web XML

Aby uzyskać więcej informacji dotyczących odwołań usług XML sieci Web, zobacz Web References.

Odwołania aplikacji Windows Store

Odwołania do projektu

projekty Sklepu Windows, których elementem docelowym jest Windows 8 nie mogą być zależne od projektów Windows Store lub plików binarnych, których elementem docelowym jest Windows 8,1.

Jeśli dowolny projekt w aplikacji jest przeznaczony dla systemu Windows 8,1, a Twoja aplikacja składa się z projektu w języku C++ dla Sklepu Windows, należy wykonać następujące czynności:

Przekieruj wszystkie projekty w aplikacji do systemu Windows 8,1.Kliknij prawym przyciskiem myszy każdy projekt w aplikacji i wybierz polecenie Przekieruj do systemu Windows 8.1, a następnie kliknij przycisk OK w oknie dialogowym Przegląd zmian projektu i rozwiązania.
Kliknij prawym przyciskiem myszy każdy projekt Visual Basic, Visual C# lub JavaScript, który zależy od projektu C++ ze Sklepu Windows, wybierz polecenie Dodaj odwołanie, przejdź na kartę Windows, a następnie podkartę Rozszerzenia, usuń zaznaczenie pola wyboru Pakiet Microsoft Visual C++ Runtime wersja 11.0 i zaznacz pole wyboru Pakiet Microsoft Visual C++ Runtime wersja 12.0, a następnie kliknij przycisk OK.

Projekty Windows Store języka Visual Basic, C# i JavaScript przeznaczone do systemu Windows 8,1 mogą odwoływać się do projektów Windows Store języka Visual Basic i C# dla Windows 8 pod warunkiem, że projekty te nie używają interfejsów API przestarzałych w Windows 8,1.Zobacz Migrowanie aplikacji systemu Windows 8 do systemu Windows 8.1 Preview, aby dowiedzieć się, czy projekty ze Sklepu Windows ukierunkowane na system Windows 8 będą nadal działać zgodnie z oczekiwaniami po odwołaniu się do nich z projektu systemu Windows 8,1.

Odwołania do zestawu SDK rozszerzeń

Projekty Windows Store języka Visual Basic, C#, C++ i JavaScript przeznaczone do systemu Windows 8,1 nie mogą odwoływać się zestawów SDK rozszerzeń, które są zależne od pakietu Microsoft Visual C++ Runtime Package v11.0, ponieważ spowoduje to problemy w czasie wykonywania.Można dowiedzieć się, czy Extension SDK zależy od Microsoft Visual C++ Runtime Package v11.0 przez stworzenie nowego projektu C# Windows Store, kliknięcie prawym klawiszem myszy na projekt i wybór Add Reference, przejście do zakładki Windows, następnie pod-zakładki Extensions, wybór Extension SDK i zobaczenie, czy prawy sektor w Reference Manager wyświetla listę Microsoft.VCLibs, version = 11.0 jako strukturę zależną.

Projekty Windows Store języka Visual Basic, C# i JavaScript przeznaczone do systemu Windows 8,1 mogą odwoływać się do zestawów SDK rozszerzeń, które nie są zależne od pakietu Microsoft Visual C++ Runtime Package v11.0, jeśli te zestawy SDK nie używają interfejsów API przestarzałych w Windows 8,1.Sprawdź, czy rozszerzenie witryny dostawcy SDK, aby dowiedzieć się, czy można się odwoływać do projektów Sklepy Windows, na które jest nastawione Windows 8,1.

Jeśli stwierdzisz, że zestaw SDK rozszerzeń, do którego odwołuje się aplikacja, nie jest obsługiwany, należy wykonać następujące czynności:

Spójrz na nazwę projektu, który jest przyczyną błędu.Platforma, dla której przeznaczony jest projekt, jest podana w nawiasie obok nazwy projektu.Na przykład NazwaMojegoProjektu (Windows 8.1) oznacza, że projekt NazwaMojegoProjektu jest przeznaczony dla wersji platformy Windows 8,1.

Przejdź do witryny dostawcy, który jest właścicielem nieobsługiwanego zestawu SDK rozszerzeń, i zainstaluj wersję zestawu SDK rozszerzeń z zależnościami, które są zgodne z wersją platformy, dla której projekt jest adresowany.

[!UWAGA]

Jednym sposobem, aby dowiedzieć się, czy Rozszerzenie SDK rozszerzeń ma zależności od innych zestawów rozszerzeń SDK jest ponowne uruchomienie program Visual Studio. Następnie utwórz nowy projekt C# Sklepu Windows, kliknij prawym przyciskiem myszy nad projektem i wybierz polecenie Dodaj odwołanie. Przejdź do karty Okna, przejdź do karty podrzędnej Rozszerzenia, zaznacz SDK rozszerzeń i przejrzyj okienko po prawej stronie w Menedżerze odwołań.Jeśli ma zależności, będą one tam wymienione.

Ważne
Jeśli projekt jest przeznaczony dla systemu Windows 8,1, a zestaw SDK rozszerzeń zainstalowany w poprzednim kroku ma zależność od pakietu środowiska uruchomieniowego języka Microsoft Visual C++, wersją pakietu środowiska uruchomieniowego języka Microsoft Visual C++ zgodną z systemem Windows 8.1 jest v12.0 i jest ona instalowana razem z programem Visual Studio 2013.

Jeśli zestaw SDK rozszerzeń zainstalowany we wcześniejszym 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, i zainstaluj wersje tych zależności, które są zgodne z wersją platformy, dla której projekt jest adresowany.
Ponownie uruchom program Visual Studio i otwórz swoją aplikację.
Kliknij prawym przyciskiem myszy projekt, który spowodował błąd, i wybierz polecenie Dodaj odwołanie (w przypadku projektów Visual Basic, C# lub JavaScript) albo polecenie Odwołania (w przypadku projektów C++).Dla projektów w języku C++ kliknij przycisk Dodaj nowe odwołanie.
Kliknij kartę Windows a następnie podkartę Rozszerzenia, następnie usuń zaznaczenie pola wyboru dla starego Rozszerzenie SDK i zaznacz pola wyboru dla nowego Rozszerzenie SDK.Kliknij przycisk OK.

Dodawanie Odwołania w czasie projektowania

Aby dodać jedno lub więcej odwołań w czasie projektowania, należy użyć okna dialogowego Menedżer odwołań lub Dodaj odwołanie, w zależności od typu projektu, który budujesz.Użyj okna dialogowego Reference Manager dla wszystkich aplikacji Windows Store i większości innych typów projektów.Aby uzyskać więcej informacji, zobacz Porady: dodawanie i usuwanie odwołań za pomocą Menedżera odwołań.Kilka innych typów projektów obsługuje okno dialogowe Dodaj odwołanie.Aby uzyskać więcej informacji, zobacz Porady: dodawanie i usuwanie odwołań za pomocą okna dialogowego Dodaj odwołanie.

Można użyć okna dialogowego Dodaj odwołanie, aby przejść do zestawów, które nie są wyświetlane.Nie można dodać odwołań z Global Assembly Cache (GAC), jako że jest on ściśle częścią środowiska czasu wykonywania.

Wprowadzenie odwołania do zestawu w projekcie powoduje, że program Visual Studio wyszukuje zestaw w następujących lokalizacjach:

Katalog aktualnego projektu. (Zestawy te można znaleźć za pomocą karty Przeglądaj.)
Inne katalogi projektu w tym samym rozwiązaniu. (Zestawy te można znaleźć na karcie Przeglądaj.)

Aby uzyskać więcej informacji dotyczących sposobu dodawania odwołań w czasie projektowania, zobacz Porady: dodawanie i usuwanie odwołań za pomocą okna dialogowego Dodaj odwołanie.

[!UWAGA]

Wszystkie projekty zawierają odwołanie domniemane do mscorlib.Projekty języka Visual Basic zawierają odwołanie pośrednie do Microsoft.VisualBasic.

Wszystkie projekty w programie Visual Studio zawierają odwołanie domniemane do System.Core, nawet jeśli System.Core jest usuwany z listy odwołań.

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

W czasie wykonywania, składniki muszą się znajdować albo w ścieżce wyjściowej projektu, albo w Global Assembly Cache (GAC).Jeżeli 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ść jest Prawda, odwołanie jest kopiowane do katalogu projektu podczas kompilowania projektu.Jeśli wartość jest Fałsz, odwołanie nie jest kopiowane.

W przypadku wdrażania aplikacji, która zawiera odwołanie do składnika niestandardowego, który jest zarejestrowany w globalnej pamięci podręcznej zestawów, składnik nie zostanie wdrożony z aplikacją, bez względu na wartość ustawienia CopyLocal.We wcześniejszych wersjach programu Visual Studio można ustawić właściwość CopyLocal w odwołaniu do zapewnienia, że zestaw został wdrożony.Teraz należy ręcznie dodać zestaw do folderu \Bin.Spowoduje to umieszczenie pod kontrolą całego kodu niestandardowego, zmniejszając ryzyko publikowania kodu niestandardowego, z którym użytkownik nie jest zaznajomiony.

Domyślnie właściwość CopyLocal jest ustawiona na False jeśli zestaw lub składnik znajduje się w globalnej pamięci podręcznej lub jest składnikiem struktury.W przeciwnym wypadku wartośc jest ustawiona na Prawda.Odwołania projektu do projektu są zawsze ustawione na True.

Odwoływanie się do projektu lub zestawu, który jest przeznaczony dla innej wersji systemu .NET Framework

Można tworzyć aplikacje odwołujące się do projektów lub zespołów, dla których docelowa była inna wersja systemu .NET Framework.Na przykład można utworzyć aplikację przeznaczoną dla środowiska .NET Framework 4 Client Profile odwołującą się to zestawu, który jest przeznaczony dla środowiska Program .NET Framework 2,0.Jeżeli tworzysz projekt, który jest przeznaczony dla starszej wersji programu .NET Framework, nie można ustawić odwołania w tym projekcie do projektu lub zestawu przeznaczonego dla środowiska .NET Framework 4 Client Profile lub .NET Framework w wersji 4.

Aby uzyskać więcej informacji, zobacz Przeznaczanie dla określonej wersji platformy .NET lub profilu.

Odwołania projektu do projektu i odwołania do pliku

Odwołania do plików są bezpośrednimi odwołaniami do zestawów. Można je utworzyć za pomocą karty Przeglądaj w oknie dialogowym Dodaj odwołanie.Odwołania projektu do projektu są odwołaniami do projektów, które zawierają zestawy; możesz je utworzyć za pomocą karty Przeglądaj w oknie dialogowym Dodaj odwołanie.

Zaletą odwołania projektu do projektu jest to, że tworzy ono zależność między projektami w systemie kompilacji.Dlatego projekt zależny zostanie skompilowany, jeśli zmienił się od czasu ostatniego skompilowania projektu, który się do niego odwołuje.Odwołanie pliku nie tworzy zależność kompilacji, więc istnieje możliwość skompilowania projektu z odwołaniem bez kompilowania projektu zależnego, odwołanie może się okazać zbędne. (Projekt może odwoływać się do uprzednio utworzonej wersji projektu.) Może to spowodować, że w katalogu bin będzie wymaganych kilka wersjach pojedynczego pliku DLL, co jest niemożliwe.Po wystąpieniu takiego konfliktu pojawi komunikat taki jak Ostrzeżenie: nie można skopiować zależności 'plik' w projekcie 'projekt' do katalogu uruchomienia, ponieważ zastąpiłaby ona odwołanie 'plik'..

Nie należy dodawać odwołań do pliku do danych wyjściowych innego projektu w tym samym rozwiązaniu, ponieważ w ten sposób można spowodować błędy kompilacji.Zamiast tego należy użyć zakłądki Projektyów w oknie dialogowym Dodaj odwołanie , aby utworzyć projekt odwołania w tym samym rozwiązaniu.Ułatwia to projektowanie zespołowe poprzez umożliwienie lepszego zarządzania bibliotekami klas utworzonymi w projektach.Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z przerwanymi odwołaniami i Porady: tworzenie lub usuwanie zależności projektu.

[!UWAGA]

Odwołanie pliku zamiast odwołania projektu zostaje utworzone, jeśli wersją docelowa systemu .NET Framework jednego projektu jest wersja 4.5 a wersją docelową innego projektu jest w wersja 2, 3, 3.5 lub 4.0.

Odwołania sieci Web

Można również dodać odwołania sieci Web za pomocą okna dialogowego Dodawanie odwołań sieci Web.Aby uzyskać więcej informacji, zobacz How to: Add and Remove Web References.

Zobacz też