Strona właściwości katalogów VC + + (system Windows)VC++ Directories Property Page (Windows)

Ta strona właściwości służy do informowania programu Visual Studio o katalogach, które będą używane podczas kompilowania aktualnie wybranego projektu.Use this property page to tell Visual Studio which directories to use when building the currently-selected project. Aby ustawić katalogi dla wielu projektów w rozwiązaniu, Użyj niestandardowego arkusza właściwości, zgodnie z opisem w temacie udostępnianie lub ponowne użycie ustawień projektu programu Visual Studio C++.To set directories for multiple projects in a solution, use a custom property sheet as described in Share or reuse Visual Studio C++ project settings.

Aby uzyskać wersję systemu Linux na tej stronie, zobacz Katalogi VC + + (Linux C++).For the Linux version of this page, see VC++ Directories (Linux C++).

Aby uzyskać dostęp do strony właściwości katalogów VC + + :To access the VC++ Directories property page:

  1. Jeśli okno Eksplorator rozwiązań nie jest widoczne, w menu głównym wybierz polecenie Wyświetl > Eksplorator rozwiązań.If the Solution Explorer window is not visible, then on the main menu choose View > Solution Explorer.
  2. Kliknij prawym przyciskiem myszy węzeł projektu (nie rozwiązanie najwyższego poziomu) i wybierz polecenie Właściwości.Right-click on a project node (not the top-level solution) and choose Properties.
  3. W lewym okienku okna dialogowego strony właściwości wybierz kolejno pozycje Właściwości konfiguracji > Katalogi VC + +.In the left pane of the Property Pages dialog box, select Configuration Properties > VC++ Directories.

Właściwości katalogów VC + + dotyczą projektu, a nie węzła rozwiązania najwyższego poziomu.VC++ Directories properties apply to a project, not the top-level solution node. Jeśli nie widzisz katalogów VC + + w obszarze Właściwości konfiguracji, wybierz węzeł projektu C++ w oknie Eksplorator rozwiązań :If you do not see VC++ Directories under Configuration Properties, select a C++ project node in the Solution Explorer window:

Wybierz węzeł projektuSelect the project node

Należy pamiętać, że strona właściwości katalogów VC + + dla projektów międzyplatformowych wygląda inaczej.Note that the VC++ Directories property page for cross-platform projects looks different. Aby uzyskać informacje specyficzne dla projektów systemu Linux C++, zobacz Katalogi VC + + (Linux C++).For information specific to Linux C++ projects, see VC++ Directories (Linux C++).

Jeśli nie znasz właściwości projektu w programie Visual Studio, warto zapoznać się z tematem pierwsze odczytywanie ustawienia kompilatora C++ i właściwości kompilacji w programie Visual Studio.If you are not familiar with project properties in Visual Studio, you might find it helpful to first read Set C++ compiler and build properties in Visual Studio.

Ustawienia domyślne właściwości katalogów VC + + zależą od typu projektu.The default settings for VC++ Directories properties depend on project type. W przypadku projektów klasycznych obejmują lokalizacje narzędzi C++ dla określonego zestawu narzędzi platformy i lokalizacji Windows SDK.For desktop projects they include the C++ tools locations for a particular Platform Toolset and the Windows SDK location. Zestaw narzędzi platformy i wersję Windows SDK można zmienić na stronie Ogólne Właściwości konfiguracji > .You can change the Platform Toolset and Windows SDK version on the Configuration Properties > General page.

Aby wyświetlić wartości dla dowolnego katalogu:To view the values for any of the directories:

  1. Wybierz jedną z właściwości na stronie katalogów VC + + .Select one of the properties in the VC++ Directories page. Na przykład wybierz pozycję katalogi bibliotek.For example, choose Library Directories.
  2. Wybierz przycisk strzałki w dół na końcu pola wartość właściwości.Choose the down-arrow button at the end of the property value field.
  3. Z menu rozwijanego wybierz polecenie Edytuj.In the drop-down menu, choose Edit.

Edytuj katalogi bibliotekiEdit Library Directories

Zobaczysz teraz okno dialogowe podobne do tego:You now see a dialog box like this:

Pokaż katalogi bibliotekShow Library Directories

To okno dialogowe służy do wyświetlania bieżących katalogów.Use this dialog to view the current directories. Jeśli jednak chcesz zmienić lub dodać katalog, lepiej jest użyć Menedżer właściwości , aby utworzyć arkusz właściwości, lub zmodyfikować domyślny arkusz właściwości użytkownika.However, if you want to change or add a directory, it is better to use Property Manager to create a property sheet or modify the default user property sheet. Aby uzyskać więcej informacji, zobacz udostępnianie lub ponowne używanie ustawień projektu programu Visual Studio C++.For more information, see Share or reuse Visual Studio C++ project settings.

Jak pokazano powyżej, wiele dziedziczonych ścieżek jest podawanych jako makra.As shown above, many of the inherited paths are given as macros. Aby przejrzeć bieżącą wartość makra, wybierz przycisk makra w prawym dolnym rogu okna dialogowego.To examine the current value of a macro, choose the Macros button in the lower right corner of the dialog box. Należy zauważyć, że wiele makr zależy od typu konfiguracji.Note that many macros depend on the configuration type. Makro w kompilacji debugowania może oszacować inną ścieżkę niż to samo makro w kompilacji wydania.A macro in a debug build might evaluate to a different path than the same macro in a release build.

Możesz wyszukać częściowe lub kompletne dopasowania w polu edycji.You can search for partial or complete matches in the edit box. Na poniższej ilustracji przedstawiono wszystkie makra, które zawierają ciąg "WindowsSDK", a także ścieżkę bieżącą, którą to makro daje:The following illustration shows all the macros that contain the string "WindowsSDK" and it also shows the current path that the macro evaluates to:

Wyświetlanie wartości makrSee macro values

Uwaga: lista jest wypełniana podczas pisania.Note: The list is populated as you type. Nie naciskaj klawisza Enter.Don't press Enter.

Aby uzyskać więcej informacji na temat makr i przyczyn ich używania zamiast ścieżek zakodowanych w miarę możliwości, zobacz Ustawianie kompilatora C++ i właściwości kompilacji w programie Visual Studio.For more information about macros and why you should use them instead of hard-coded paths whenever possible, see Set C++ compiler and build properties in Visual Studio.

Listę często używanych makr można znaleźć w temacie Common MACROS for Build Commands and Properties.For a list of commonly used macros, see Common macros for build commands and properties.

Własne makra można definiować na dwa sposoby:You can define your own macros in two ways:

  • Ustaw zmienne środowiskowe w wierszu polecenia dewelopera.Set environment variables in a developer command prompt. Wszystkie zmienne środowiskowe są traktowane jako właściwości i makra programu MSBuild.All environment variables are treated as MSBuild properties/macros.

  • Zdefiniuj makra użytkownika w pliku. props.Define user macros in a .props file. Aby uzyskać więcej informacji, zobacz makra strony właściwości.For more information, see Property page macros.

Aby uzyskać więcej informacji, zobacz dziedziczenie właściwości w projektach programu Visual Studioi te wpisy w blogu: Katalogi VC + +, Przewodnik po uaktualnieniu projektu Visual Studio 2010 C++.For more information, see Property inheritance in Visual Studio projects, and these blog posts: VC++ Directories, Visual Studio 2010 C++ Project Upgrade Guide.

Typy katalogówDirectory Types

Można również określić inne katalogi, jak poniżej.You can also specify other directories, as follows.

Katalogi wykonywalneExecutable Directories
Katalogi, w których należy szukać plików wykonywalnych.Directories in which to search for executable files. Odpowiada zmiennej środowiskowej Path .Corresponds to the PATH environment variable.

Katalogi dołączaniaInclude Directories
Katalogi, w których należy szukać dołączanych plików, do których istnieją odwołania w kodzie źródłowym.Directories in which to search for include files that are referenced in the source code. Odnosi się do zmiennej środowiskowej include .Corresponds to the INCLUDE environment variable.

Katalogi odwołańReference Directories
Katalogi, w których mają być wyszukiwane pliki zestawów i modułów (metadane), które są przywoływane w kodzie źródłowym przez dyrektywę #using .Directories in which to search for assembly and module (metadata) files that are referenced in the source code by the #using directive. Odnosi się do zmiennej środowiskowej LIBPATH .Corresponds to the LIBPATH environment variable.

Katalogi bibliotekLibrary Directories
Katalogi, w których należy szukać plików biblioteki (.lib); obejmują biblioteki wykonywalne.Directories in which to search for libraries (.lib) files; this includes run-time libraries. Odpowiada zmiennej środowiskowej lib .Corresponds to the LIB environment variable. To ustawienie nie ma zastosowania do plików. obj; Aby utworzyć link do pliku. obj, na > stronie właściwości ogólne konsolidatora właściwości konfiguracji > wybierz pozycję dodatkowe zależności biblioteki , a następnie określ ścieżkę względną pliku.This setting does not apply to .obj files; to link to an .obj file, on the Configuration Properties > Linker > General property page, select Additional Library Dependencies and then specify the relative path of the file. Aby uzyskać więcej informacji, zobacz strony właściwości konsolidatora.For more information, see Linker property pages.

Katalogi WinRTLibrary WinRT Directories
Katalogi do wyszukiwania plików biblioteki WinRT do użycia w aplikacjach platforma uniwersalna systemu Windows (platformy UWP).Directories to search for WinRT library files for use in Universal Windows Platform (UWP) apps.

Katalogi źródłoweSource Directories
Katalogi, w których należy szukać plików źródłowych dla technologii IntelliSense.Directories in which to search for source files to use for IntelliSense.

Wyklucz katalogiExclude Directories
Przed każdą kompilacją program Visual Studio wysyła zapytanie do sygnatury czasowej dla wszystkich plików, aby określić, czy którykolwiek z nich został zmodyfikowany od czasu poprzedniej kompilacji.Before each compilation, Visual Studio queries the timestamp on all files to determine whether any have been modified since the previous compilation. Jeśli projekt ma duże stabilne biblioteki, można skrócić czas kompilacji, wykluczając te katalogi ze sprawdzenia sygnatury czasowej.If your project has large stable libraries, you can potentially speed up build times by excluding those directories from the timestamp check.

Współdzielenie ustawieńSharing the Settings

Właściwości projektu można udostępniać innym użytkownikom lub na wielu komputerach.You can share project properties with other users or across multiple computers. Aby uzyskać więcej informacji, zobacz Ustawianie kompilatora C++ i właściwości kompilacji w programie Visual Studio.For more information, see Set C++ compiler and build properties in Visual Studio.