Udostępnianie lub ponowne używanie ustawień projektów programu Visual StudioShare or reuse Visual Studio project settings

Aby utworzyć niestandardową grupę ustawień, które można udostępniać innym osobom lub użyć ich ponownie w wielu projektach, użyj Menedżer właściwości , aby utworzyć Arkusz właściwości (. props) do przechowywania ustawień dla każdego rodzaju projektu, które mają być możliwe do ponownego użycia lub udostępnienia innym osobom.To create a custom group of settings that you can share with others or reuse in multiple projects, use Property Manager to create a property sheet (.props file) to store the settings for each kind of project that you want to be able to reuse or share with others. Używanie arkuszy właściwości jest znacznie mniej podatne na błędy niż inne sposoby tworzenia ustawień globalnych.Using property sheets are far less error-prone than other ways of creating "global" settings.

Ważne

pliki. User i dlaczego są problematyczne.user files and why they are problematic

Wcześniejsze wersje programu Visual Studio używały globalnych arkuszy właściwości, które mają rozszerzenie nazwy pliku. User i znajdowały się w <userprofile> folderze \AppData\Local\Microsoft\MSBuild\v4.0.Past versions of Visual Studio used global property sheets that had a .user file name extension and were located in the <userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\ folder. Firma Microsoft nie zaleca już używania tych plików, ponieważ ustawiają one właściwości konfiguracji projektu dla poszczególnych użytkowników i konkretnych komputerów.We no longer recommend these files because they set properties for project configurations on a per-user, per-computer basis. Takie ustawienia „globalne” mogą zakłócać kompilacje, zwłaszcza gdy są one ukierunkowane na więcej niż jedną platformę na komputerze kompilacji.Such "global" settings can interfere with builds, especially when you are targeting more than one platform on your build computer. Na przykład, jeśli masz zarówno projekt MFC, jak i projekt Windows Phone, właściwości .user byłyby nieprawidłowe dla jednego z nich.For example, if you have both an MFC project and Windows Phone project, the .user properties would be invalid for one of them. Arkusze właściwości wielokrotnego użytku są bardziej elastyczne i bardziej niezawodne.Reusable property sheets are more flexible and more robust.

Pomimo tego, że pliki .user są nadal instalowane przez Visual Studio i uczestniczą w dziedziczeniu właściwości, są one domyślnie puste.Although .user files are still installed by Visual Studio and participate in property inheritance, they are empty by default. Najlepszym rozwiązaniem jest usunięcie odwołania do nich w Menedżer właściwości , aby upewnić się, że projekty działają niezależnie od wszelkich ustawień dla poszczególnych użytkowników i komputerów, jest to ważne, aby zapewnić poprawne zachowanie w środowisku SCC (kontroli kodu źródłowego).The best practice is to delete the reference to them in Property Manager to ensure that your projects operate independently of any per-user, per-computer settings This is important to ensure correct behavior in a SCC (source code control) environment.

Aby wyświetlić Menedżer właściwości, na pasku menu wybierz pozycję Wyświetl > Menedżer właściwości lub Wyświetl > inne > Menedżer właściwości Windows, w zależności od ustawień.To display Property Manager, on the menu bar, choose View > Property Manager or View > Other Windows > Property Manager, depending on your settings.

Jeśli masz wspólny, często używany zestaw właściwości, które chcesz zastosować do wielu projektów, możesz użyć Menedżer właściwości do przechwycenia ich w pliku arkusza właściwości wielokrotnego użytku, który Konwencji ma rozszerzenie nazwy pliku. props.If you have a common, frequently used set of properties that you want to apply to multiple projects, you can use Property Manager to capture them in a reusable property sheet file, which by convention has a .props file name extension. Arkusz (lub arkusze) można stosować do nowych projektów, aby nie było konieczne ustawianie ich właściwości od podstaw.You can apply the sheet (or sheets) to new projects so that you don't have to set its properties from scratch.

Menedżer właściwości menu skrótówProperty Manager shortcut menu

W każdym węźle konfiguracji są wyświetlane węzły dla każdego arkusza właściwości, który ma zastosowanie do tej konfiguracji.Under each configuration node, you see nodes for each property sheet that applies to that configuration. System dodaje arkusze właściwości, które ustawiają wartości na podstawie opcji wybranych w Kreatorze aplikacji podczas tworzenia projektu.The system adds property sheets that set values based on options you choose in the app wizard when you create the project. Kliknij prawym przyciskiem myszy dowolny węzeł i wybierz polecenie Właściwości, aby wyświetlić właściwości, które mają zastosowanie do tego węzła.Right-click any node and choose Properties to see the properties that apply to that node. Wszystkie arkusze właściwości są importowane automatycznie do arkusza właściwości projektu "Master" (MS. cpp. props) i są oceniane w kolejności, w jakiej występują w Menedżer właściwości.All the property sheets are imported automatically into the project's "master" property sheet (ms.cpp.props) and are evaluated in the order they appear in Property Manager. Można je przenieść, aby zmienić kolejność szacowania.You can move them to change the evaluation order. Arkusze właściwości, które są oceniane później, przesłonią wartości w poprzednio ocenionych arkuszach.Property sheets that are evaluated later will override the values in previously-evaluated sheets. Zobacz dziedziczenie właściwości projektu , aby uzyskać więcej informacji na temat kolejności oceny w pliku. vcxproj, pliki. props i. targets, zmienne środowiskowe i wiersz polecenia.See Project property inheritance for more information about the order of evaluation in the .vcxproj file, the .props and .targets files, environment variables and the command line.

Jeśli wybierzesz opcję Dodaj nowy arkusz właściwości projektu , a następnie wybierzesz na przykład arkusz właściwości webprops. props, pojawi się okno dialogowe strony właściwości.If you choose Add New Project Property Sheet and then select, for example, the MyProps.props property sheet, a property page dialog box appears. Należy zauważyć, że ma ona zastosowanie do arkusza właściwości MyProps; wszelkie wprowadzone zmiany są zapisywane w arkuszu, a nie w pliku projektu (.vcxproj).Notice that it applies to the MyProps property sheet; any changes you make are written to the sheet, not to the project file (.vcxproj).

Właściwości w arkuszu właściwości zostaną zastąpione, jeśli ustawiono tę samą właściwość bezpośrednio w pliku .vcxproj.Properties in a property sheet are overridden if the same property is set directly in the .vcxproj file.

Można importować arkusz własności tak często, jak jest to wymagane.You can import a property sheet as often as required. Wiele projektów w rozwiązaniu może dziedziczyć ustawienia z tego samego arkusza właściwości, a projekt może mieć wiele arkuszy.Multiple projects in a solution can inherit settings from the same property sheet, and a project can have multiple sheets. Arkusz właściwości może dziedziczyć ustawienia z innego arkusza właściwości.A property sheet itself can inherit settings from another property sheet.

Można również utworzyć jeden arkusz właściwości dla wielu konfiguracji.You can also create one property sheet for multiple configurations. W tym celu Utwórz arkusz właściwości dla każdej konfiguracji, otwórz menu skrótów dla jednego z nich, wybierz polecenie Dodaj istniejący arkusz właściwości, a następnie Dodaj inne arkusze.To do this, create a property sheet for each configuration, open the shortcut menu for one of them, choose Add Existing Property Sheet, and then add the other sheets. Jednak jeśli używasz jednego wspólnego arkusza właściwości, należy pamiętać, że po ustawieniu właściwości jest ona ustawiana dla wszystkich konfiguracji, do których odnosi się arkusz, i że IDE nie pokazuje, które projekty lub inne arkusze właściwości są dziedziczone z danego arkusza właściwości.However, if you use one common property sheet, be aware that when you set a property, it gets set for all configurations that the sheet applies to, and that the IDE doesn't show which projects or other property sheets are inheriting from a given property sheet.

W dużych rozwiązaniach, które będą miały wiele projektów, może być przydatne utworzenie arkusza właściwości na poziomie rozwiązania.In large solutions that will have many projects, it can be useful to create a property sheet at the solution level. Po dodaniu projektu do rozwiązania, użyj Menedżer właściwości , aby dodać ten arkusz właściwości do projektu.When you add a project to the solution, use Property Manager to add that property sheet to the project. Jeśli jest to wymagane na poziomie projektu, można dodać nowy arkusz właściwości do ustawiania wartości specyficznych dla projektu.If required at the project level, you can add a new property sheet to set project-specific values.

Ważne

Domyślnie plik. props nie uczestniczy w kontroli źródła, ponieważ nie jest utworzony jako element projektu.A .props file by default does not participate in source control because it isn't created as a project item. Można ręcznie dodać plik jako element rozwiązania, jeżeli chce się go włączyć do kontroli źródła.You can manually add the file as a solution item if you want to include it in source control.

Aby utworzyć arkusz właściwościTo create a property sheet

  1. Na pasku menu wybierz polecenie Wyświetl > Menedżer właściwości lub Wyświetl > inne Menedżer właściwości systemu Windows > .On the menu bar, choose View > Property Manager or View > Other Windows > Property Manager. Zostanie otwarty Menedżer właściwości .The Property Manager opens.

  2. Aby zdefiniować zakres arkusza właściwości, wybierz element, do którego ma to zastosowanie.To define the scope of the property sheet, select the item to which it applies. Może to być określona konfiguracja lub inny arkusz właściwości.This can be a particular configuration, or another property sheet. Otwórz menu skrótów dla tego elementu, a następnie wybierz polecenie Dodaj nowy projekt arkusza właściwości.Open the shortcut menu for this item and then choose Add New Project Property Sheet. Określ nazwę i lokalizację.Specify a name and location.

  3. W Menedżer właściwości Otwórz nowy arkusz właściwości, a następnie ustaw właściwości, które chcesz uwzględnić.In Property Manager, open the new property sheet and then set the properties you want to include.