Typowe właściwości projektu MSBuild
W poniższej tabeli wymieniono często używane właściwości zdefiniowane w plikach projektu programu Visual Studio lub zawarte w plikach .targets zapewnianych przez program MSBuild.
Pliki projektu w programie Visual Studio (.csproj, .vbproj, .vcxproji inne) zawierają kod XML programu MSBuild uruchamiany podczas tworzenia projektu przy użyciu środowiska IDE. Projekty zazwyczaj importują jeden lub więcej plików .targets w celu zdefiniowania procesu kompilacji. Aby uzyskać więcej informacji, zobacz pliki MSBuild .targets.
Podczas ustawiania wartości właściwości należy pamiętać, że typowe właściwości mogą być ustawiane, resetowane lub używane w wielu importowanych plikach. W związku z tym należy ustawić właściwość w pliku projektu w Directory.Build.propslub w innym zaimportowanym pliku. Jeśli ustawiasz właściwość gdzieś i nie otrzymujesz oczekiwanego wyniku, rozważ, gdzie i jak właściwość jest zmieniana lub używana we wszystkich plikach importowanych przez projekt, w tym importach, które są dodawane niejawnie podczas korzystania z atrybutu Sdk. Zobacz Wybieranie między dodawaniem właściwości do pliku .props lub targets. Wstępne przetwarzanie może pomóc w tym celu (zobacz opcję wiersza polecenia /preprocess lub /pp w odwołanie wiersza polecenia MSBuild).
Lista typowych właściwości i parametrów
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| AdditionalLibPaths | .SIEĆ | Określa dodatkowe foldery, w których kompilatory powinny szukać zestawów odwołań. |
| Tryby dodawania | .SIEĆ | Powoduje, że kompilator udostępnia wszystkie informacje o typie z określonych plików kompilowaniu projektu. Ta właściwość jest równoważna przełącznikowi kompilatora /addModules. |
| ALToolPath | .SIEĆ | Ścieżka do AL.exe. Ta właściwość zastępuje bieżącą wersję AL.exe, aby umożliwić korzystanie z innej wersji. |
| ApplicationIcon | .SIEĆ | Plik ikony .ico przekazywany do kompilatora na potrzeby osadzania jako ikona Win32. Właściwość jest równoważna przełącznikowi kompilatora /win32icon. |
| ApplicationManifest | Cały | Określa ścieżkę pliku, który jest używany do generowania zewnętrznych informacji o manifeście kontroli konta użytkownika (UAC). Dotyczy tylko projektów programu Visual Studio przeznaczonych dla systemu Windows Vista. W większości przypadków manifest jest osadzony. Jeśli jednak używasz bezpłatnego wdrożenia com lub ClickOnce rejestracji, manifest może być plikiem zewnętrznym zainstalowanym razem z zestawami aplikacji. Aby uzyskać więcej informacji, zobacz właściwość NoWin32Manifest w tym artykule. |
| AssemblyOriginatorKeyFile | .SIEĆ | Określa plik używany do podpisywania zestawu (.snk lub .pfx) i jest przekazywany do zadania ResolveKeySource w celu wygenerowania rzeczywistego klucza użytego do podpisania zestawu. |
| AssemblySearchPaths | .SIEĆ | Lista lokalizacji do wyszukania podczas rozpoznawania zestawów odwołań w czasie kompilacji. Kolejność wyświetlania ścieżek na tej liście jest znacząca, ponieważ wymienione wcześniej ścieżki mają pierwszeństwo przed późniejszymi wpisami. |
| AssemblyName | .SIEĆ | Nazwa końcowego zestawu wyjściowego po skompiluj projekt. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| BaseAddress | .SIEĆ | Określa adres podstawowy głównego zestawu wyjściowego. Ta właściwość jest równoważna przełącznikowi kompilatora /baseaddress. |
| BaseIntermediateOutputPath | Cały | Folder najwyższego poziomu, w którym są tworzone wszystkie foldery wyjściowe pośrednie specyficzne dla konfiguracji. Wartość domyślna to obj\. Poniższy kod jest przykładem: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | Cały | Określa ścieżkę podstawową dla pliku wyjściowego. Jeśli jest ustawiona, program MSBuild używa OutputPath = $(BaseOutputPath)\$(Configuration)\. Przykładowa składnia: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | Cały | Wartość logiczna wskazująca, czy odwołania do projektu są kompilowane lub czyszczone równolegle, gdy jest używany program MSBuild z wieloma procami. Wartość domyślna to true, co oznacza, że projekty będą kompilowane równolegle, jeśli system ma wiele rdzeni lub procesorów. |
| BuildProjectReferences | Cały | Wartość logiczna wskazująca, czy odwołania do projektu są kompilowane przez program MSBuild. Automatycznie ustaw wartość na false, jeśli tworzysz projekt w zintegrowanym środowisku projektowym programu Visual Studio (IDE), true w przeciwnym razie.
-p:BuildProjectReferences=false można określić w wierszu polecenia, aby uniknąć sprawdzania, czy przywołyne projekty są aktualne. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| CleanFile | Cały | Nazwa pliku, który będzie używany jako "czysta pamięć podręczna". Czysta pamięć podręczna to lista wygenerowanych plików do usunięcia podczas operacji czyszczenia. Plik jest umieszczany w pośredniej ścieżce wyjściowej przez proces kompilacji. Ta właściwość określa tylko nazwy plików, które nie mają informacji o ścieżce. |
| Strona kodowa | .SIEĆ | Określa stronę kodową, która ma być używana dla wszystkich plików kodu źródłowego w kompilacji. Ta właściwość jest równoważna przełącznikowi kompilatora /codepage. |
| CompilerResponseFile | .SIEĆ | Opcjonalny plik odpowiedzi, który można przekazać do zadań kompilatora. |
| Konfiguracja | Cały | Konfiguracja, którą tworzysz, zazwyczaj Debug lub Release, ale można skonfigurować na poziomie rozwiązania i projektu. |
| CscToolPath | C# | Ścieżka csc.exe, kompilator języka C#. |
| CustomAfterMicrosoftCommonTargets | Cały | Nazwa pliku projektu lub pliku docelowej, który ma zostać zaimportowany automatycznie po zaimportowaniu wspólnych obiektów docelowych. |
| CustomBeforeMicrosoftCommonTargets | Cały | Nazwa pliku projektu lub pliku obiektów docelowych, który ma zostać zaimportowany automatycznie przed zaimportowanym wspólnymi elementami docelowymi. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| DebugSymbols | Cały | Wartość logiczna wskazująca, czy symbole są generowane przez kompilację. Ustawienie -p:DebugSymbols=false w wierszu polecenia wyłącza generowanie bazy danych programu (.pdb) plików symboli. |
| Typ debugowania | Cały | Definiuje poziom informacji debugowania, które chcesz wygenerować. Prawidłowe wartości to "full", "pdbonly", "portable", "embedded" i "none". |
| DefineConstants | .SIEĆ | Definiuje stałe kompilatora warunkowego. Pary symboli/wartości są rozdzielane średnikami i określane przy użyciu składni zależnej od języka: C#: symbol1; symbol2Visual Basic: symbol1 = value1, symbol2 = value2Właściwość jest równoważna przełącznikowi kompilatora /define. |
| DefineDebug | Cały | Wartość logiczna wskazująca, czy chcesz zdefiniować stałą DEBUG. |
| DefineTrace | Cały | Wartość logiczna wskazująca, czy chcesz zdefiniować stałą TRACE. |
| DelaySign | .SIEĆ | Wartość logiczna wskazująca, czy chcesz opóźnić podpisywanie zestawu, a nie pełnego podpisywania. |
| Deterministyczny | .SIEĆ | Wartość logiczna wskazująca, czy kompilator powinien produkować identyczne zestawy dla identycznych danych wejściowych. Ten parametr odpowiada przełącznikowi /deterministic kompilatorów. |
| DirectoryBuildPropsPath | Cały | Określa ścieżkę do pliku Directory.Build.props; jeśli została zdefiniowana, ta właściwość zastępuje domyślny algorytm wyszukiwania. Zobacz Dostosowywanie kompilacji. |
| DirectoryBuildTargetsPath | Cały | Określa ścieżkę do pliku Directory.Build.targets; jeśli została zdefiniowana, ta właściwość zastępuje domyślny algorytm wyszukiwania. Zobacz Dostosowywanie kompilacji. |
| DisableFastUpToDateCheck | Cały | Wartość logiczna, która ma zastosowanie tylko do programu Visual Studio. Menedżer kompilacji programu Visual Studio używa procesu o nazwie FastUpToDateCheck, aby określić, czy projekt musi zostać ponownie skompilowany, aby był aktualny. Ten proces jest szybszy niż używanie programu MSBuild do określenia tego. Ustawienie właściwości DisableFastUpToDateCheck na true pozwala pominąć menedżera kompilacji programu Visual Studio i wymusić użycie programu MSBuild w celu określenia, czy projekt jest aktualny. |
| DocumentationFile | .SIEĆ | Nazwa pliku wygenerowanego jako plik dokumentacji XML. Ta nazwa zawiera tylko nazwę pliku i nie zawiera informacji o ścieżce. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| Raport o błędach | .SIEĆ | Określa, jak zadanie kompilatora powinno zgłaszać wewnętrzne błędy kompilatora. Prawidłowe wartości to "prompt", "send" lub "none". Ta właściwość jest równoważna przełącznikowi kompilatora /errorreport. |
| ExcludeDeploymentUrl | .SIEĆ | Zadanie generateDeploymentManifest dodaje tag deploymentProvider do manifestu wdrożenia, jeśli plik projektu zawiera dowolny z następujących elementów: - UpdateUrl - InstallUrl - PublishUrl Przy użyciu polecenia ExcludeDeploymentUrl można jednak uniemożliwić dodanie tagu deploymentProvider do manifestu wdrożenia, nawet jeśli określono którykolwiek z powyższych adresów URL. W tym celu dodaj następującą właściwość do pliku projektu: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Uwaga: ExcludeDeploymentUrl nie jest uwidoczniona w środowisku IDE programu Visual Studio i można ustawić tylko ręcznie edytując plik projektu. Ustawienie tej właściwości nie ma wpływu na publikowanie w programie Visual Studio; oznacza to, że tag deploymentProvider będzie nadal dodawany do adresu URL określonego przez publishUrl. |
| FileAlignment | .SIEĆ | Określa w bajtach, gdzie wyrównywać sekcje pliku wyjściowego. Prawidłowe wartości to 512, 1024, 2048, 4096, 8192. Ta właściwość jest równoważna przełącznikowi kompilatora /filealignment. |
| FrameworkPathOverride | Visual Basic | Określa lokalizację mscorlib.dll i microsoft.visualbasic.dll. Ten parametr jest odpowiednikiem przełącznika /sdkpath kompilatora vbc.exe. |
| GenerateDocumentationFile | .SIEĆ | Parametr logiczny wskazujący, czy dokumentacja jest generowana przez kompilację. Jeśli true, kompilacja generuje informacje o dokumentacji i umieszcza je w pliku .xml wraz z nazwą pliku wykonywalnego lub biblioteki utworzonej przez zadanie kompilacji. |
| GenerateFullPaths | C# | Wygeneruj pełne ścieżki dla nazw plików w danych wyjściowych przy użyciu opcji -fullpaths kompilatora. |
| GenerateSerializationAssemblies | .SIEĆ | Wskazuje, czy zestawy serializacji XML powinny być generowane przez SGen.exe, które można ustawić na włączone, automatyczne lub wyłączone. Ta właściwość jest używana w przypadku zestawów przeznaczonych tylko dla platformy .NET Framework. Aby wygenerować zestawy serializacji XML dla zestawów .NET Standard lub .NET Core, zapoznaj się z pakietem NuGet Microsoft.XmlSerializer. Generator. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| ImportDirectoryBuildProps | Cały | Wartość logiczna wskazująca, czy zaimportować plik Directory.Build.props. Zobacz Dostosowywanie kompilacji. |
| ImportDirectoryBuildTargets | Cały | Wartość logiczna wskazująca, czy zaimportować plik Directory.Build.targets. Zobacz Dostosowywanie kompilacji. |
| IntermediateOutputPath | Cały | Pełna ścieżka danych wyjściowych pośrednich pochodząca z BaseIntermediateOutputPath, jeśli nie określono żadnej ścieżki. Na przykład obj\debug\. |
| KeyContainerName | Cały | Nazwa kontenera klucza o silnej nazwie. |
| KeyOriginatorFile | Cały | Nazwa pliku klucza silnej nazwy. |
| ModuleAssemblyName | .SIEĆ | Nazwa zestawu, do którego ma zostać włączony skompilowany moduł. Właściwość jest równoważna przełącznikowi kompilatora /moduleassemblyname. |
| MSBuildProjectExtensionsPath | Cały | Określa ścieżkę, w której znajdują się rozszerzenia projektu. Domyślnie przyjmuje tę samą wartość co BaseIntermediateOutputPath. |
| MSBuildTreatWarningsAsErrors | Cały | Wartość logiczna, która nakazuje programowi MSBuild traktowanie wszystkich ostrzeżeń jako błędów, chyba że zostaną pominięte. |
| MSBuildWarningsAsErrors | Cały | Określa listę kodów ostrzegawczych, które mają być traktowane jako błędy. Oddziel wiele ostrzeżeń średnikami. Jeśli używasz właściwości zestawu .NET SDK WarningsAsErrors, MSBuildWarningsAsErrors będzie domyślnie wartością WarningsAsErrors. |
| MSBuildWarningsAsMessages | Cały | Określa listę kodów ostrzegawczych, które mają być pomijane, traktując je jako komunikaty o niskiej ważności. Oddziel wiele ostrzeżeń średnikami. Należy pamiętać, że niektóre ostrzeżenia emitowane przez program MSBuild nie mogą być pomijane przy użyciu tej właściwości; aby je pominąć, użyj przełącznika wiersza polecenia -warnAsMessage. Jeśli używasz właściwości zestawu .NET SDK NoWarn, MSBuildWarningsAsMessages będzie domyślnie wartością NoWarn. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| NoLogo | Cały | Wartość logiczna wskazująca, czy logo kompilatora ma być wyłączone. Ta właściwość jest równoważna przełącznikowi kompilatora /nologo. |
| NoStdLib | .SIEĆ | Wartość logiczna wskazująca, czy uniknąć odwoływania się do standardowej biblioteki (mscorlib.dll). Wartość domyślna to false. |
| NoVBRuntimeReference | Visual Basic | Wartość logiczna wskazująca, czy środowisko uruchomieniowe Języka Visual Basic (Microsoft.VisualBasic.dll) powinno zostać uwzględnione jako odwołanie w projekcie. |
| NoWarn | .SIEĆ | Pomija określone ostrzeżenia. Należy określić tylko część liczbową identyfikatora ostrzeżenia. Wiele ostrzeżeń jest rozdzielonych średnikami. Ten parametr odpowiada przełącznikowi /nowarn kompilatorów. |
| NoWin32Manifest | .SIEĆ | Wartość logiczna wskazująca, czy informacje o manifeście kontroli konta użytkownika (UAC) zostaną osadzone w pliku wykonywalnym aplikacji. Dotyczy tylko projektów programu Visual Studio przeznaczonych dla systemu Windows Vista. W projektach wdrożonych przy użyciu technologii ClickOnce i Registration-Free COM ten element jest ignorowany.
False (wartość domyślna) określa, że informacje o manifeście kontroli konta użytkownika (UAC) są osadzone w pliku wykonywalny aplikacji.
True określa, że informacje o manifeście kontroli dostępu użytkownika nie są osadzone.Ta właściwość ma zastosowanie tylko do projektów programu Visual Studio przeznaczonych dla systemu Windows Vista. W projektach wdrożonych przy użyciu technologii ClickOnce i Registration-Free COM ta właściwość jest ignorowana. Należy dodać program NoWin32Manifest tylko wtedy, gdy program Visual Studio nie ma osadzić żadnych informacji o manifeście w pliku wykonywalny aplikacji; ten proces jest nazywany wirtualizacji. Aby użyć wirtualizacji, ustaw <ApplicationManifest> w połączeniu z <NoWin32Manifest> w następujący sposób:— W przypadku projektów Visual Basic usuń węzeł <ApplicationManifest>. (W projektach Visual Basic <NoWin32Manifest> jest ignorowany, gdy istnieje węzeł <ApplicationManifest>).— W przypadku projektów w języku C# ustaw <ApplicationManifest>False i <NoWin32Manifest> na True. (W projektach języka C# <ApplicationManifest> przesłonięcia <NoWin32Manifest>.)Ta właściwość jest równoważna przełącznikowi kompilatora /nowin32manifestvbc.exe. |
| Optymalizować | .SIEĆ | Wartość logiczna ustawiona na trueumożliwia optymalizacje kompilatora. Ta właściwość jest równoważna przełącznikowi kompilatora /optimize. |
| OpcjaCompare | VisualBasic | Określa sposób wykonywania porównań ciągów. Prawidłowe wartości to "binary" lub "text". Ta właściwość jest równoważna przełącznikowi kompilatora /optioncomparevbc.exe. |
| OptionExplicit | Visual Basic | Wartość logiczna ustawiona na truewymaga jawnej deklaracji zmiennych w kodzie źródłowym. Ta właściwość jest równoważna przełącznikowi kompilatora /optionexplicit. |
| OptionInfer | Visual Basic | Wartość logiczna ustawiona na trueumożliwia wnioskowanie typów zmiennych. Ta właściwość jest równoważna przełącznikowi kompilatora /optioninfer. |
| OptionStrict | Visual Basic | Wartość logiczna ustawiona na truepowoduje, że zadanie kompilacji wymusza semantykę typu ścisłego w celu ograniczenia niejawnych konwersji typów. Ta właściwość jest równoważna przełącznikowi /optionstrict kompilatora vbc.exe. |
| OutDir | Cały | Wskazuje końcową lokalizację danych wyjściowych dla projektu lub rozwiązania. Podczas tworzenia rozwiązania można użyć narzędzia OutDir do zbierania wielu danych wyjściowych projektu w jednej lokalizacji. Ponadto funkcja OutDir jest dołączona do obiektów AssemblySearchPaths używanych do rozpoznawania odwołań. Na przykład bin\Debug. |
| OutputPath | Cały | Określa ścieżkę do katalogu wyjściowego względem katalogu projektu, na przykład bin\Debug lub bin\Debug\$(Platform) w kompilacjach innych niż AnyCPU. |
| OutputType | Cały | Określa format pliku wyjściowego. Ten parametr może mieć jedną z następujących wartości: -Biblioteka. Tworzy bibliotekę kodu. (Wartość domyślna). - Exe. Tworzy aplikację konsolową. -Moduł. Tworzy moduł. - Winexe. Tworzy program oparty na systemie Windows. W przypadku języka C# i Visual Basic ta właściwość jest równoważna przełącznikowi /target. Typ danych wyjściowych może być automatycznie zastępowany przez wnioskowanie. Zobacz OutputType ustawioną na WinExe dla aplikacji WPF i WinForms. Wyłącz wnioskowanie, ustawiając DisableWinExeOutputInference na wartość true. |
| ZastąpReadOnlyFiles | Cały | Wartość logiczna wskazująca, czy chcesz umożliwić kompilacji zastępowanie plików tylko do odczytu, czy wyzwalanie błędu. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| PathMap | .SIEĆ | Określa sposób mapowania ścieżek fizycznych na nazwy ścieżek źródłowych wyjściowych przez kompilator. Ta właściwość jest równoważna przełącznikowi /pathmap kompilatorów. |
| Plik PDB | .SIEĆ | Nazwa pliku .pdb, który emitujesz. Ta właściwość jest równoważna przełącznikowi /pdb kompilatora csc.exe. |
| Podest | Cały | System operacyjny, dla którego tworzysz. Przykłady kompilacji programu .NET Framework to "Dowolne procesory CPU", "x86" i "x64". |
| ProcessorArchitecture | .SIEĆ | Architektura procesora używana podczas rozwiązywania odwołań do zestawów. Prawidłowe wartości to "msil", "x86", "amd64" lub "ia64". |
| ProduceOnlyReferenceAssembly | .SIEĆ | Wartość logiczna, która nakazuje kompilatorowi emitowanie tylko zestawu referencyjnego, a nie skompilowanego kodu. Nie można używać w połączeniu z ProduceReferenceAssembly. Ta właściwość odpowiada przełącznikowi /refonly kompilatorów vbc.exe i csc.exe. |
| ProduceReferenceAssembly | .SIEĆ | Wartość logiczna ustawiona na true umożliwia produkcję zestawów odwołań dla bieżącego zestawu.
Deterministic należy true w przypadku korzystania z tej funkcji. Ta właściwość odpowiada przełącznikowi /refout kompilatorów vbc.exe i csc.exe. |
| RegisterAssemblyMSBuildArchitecture | Tylko system Windows | Określa domyślną architekturę, dla której zarejestrowano zarządzaną bibliotekę DLL. Ta właściwość jest przydatna, ponieważ com używa rejestru systemu Windows do przechowywania rejestracji w gałęziach specyficznych dla architektury. Na przykład w systemie Windows zestaw zarządzany AnyCPU może mieć jego typy zarejestrowane w 64-bitowej gałęzi i/lub w 32-bitowej gałęzi (WoW), a kompilacja używa tej właściwości do określenia, która gałąź rejestru specyficzna dla architektury ma być używana. Prawidłowe wartości obejmują "x86", "x64" i "ARM64". |
| RegisterForCOMInterop | Tylko system Windows | Wskazuje, że aplikacja zarządzana uwidacznia obiekt COM (otoka wywoływana com). Zobacz stronę Kompilacja — sekcja Dane wyjściowe. To ustawienie ma wpływ tylko na maszynę, na której kompiluje się projekt. Jeśli wdrażasz na innych maszynach, wywołaj regasm.exe, aby zarejestrować zestaw na maszynie docelowej. |
| RemoveIntegerChecks | Visual Basic | Wartość logiczna wskazująca, czy wyłączyć sprawdzanie błędów przepełnienia całkowitego. Wartość domyślna to false. Ta właściwość jest równoważna przełącznikowi /removeintchecks kompilatora vbc.exe. |
| RootNamespace | Cały | Główna przestrzeń nazw używana podczas nazywania zasobu osadzonego. Ta przestrzeń nazw jest częścią osadzonej nazwy manifestu zasobu. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| Satellite_AlgorithmId | .SIEĆ | Identyfikator algorytmu tworzenia skrótów AL.exe używany podczas tworzenia zestawów satelickich. |
| Satellite_BaseAddress | .SIEĆ | Adres podstawowy używany podczas tworzenia zestawów satelickich specyficznych dla kultury przy użyciu obiektu docelowego CreateSatelliteAssemblies. |
| Satellite_CompanyName | .SIEĆ | Nazwa firmy do przekazania do AL.exe podczas generowania zestawów satelitarnych. |
| Satellite_Configuration | .SIEĆ | Nazwa konfiguracji, która ma być przekazywana do AL.exe podczas generowania zestawu satelitarnego. |
| Satellite_Description | .SIEĆ | Tekst opisu przekazywany do AL.exe podczas generowania zestawu satelitarnego. |
| Satellite_EvidenceFile | .SIEĆ | Osadza określony plik w zestawie satelitarnym o nazwie zasobu "Security.Evidence". |
| Satellite_FileVersion | .SIEĆ | Określa ciąg pola Wersja pliku w zestawie satelitarnym. |
| Satellite_Flags | .SIEĆ | Określa wartość pola Flags w zestawie satelitarnym. |
| Satellite_GenerateFullPaths | .SIEĆ | Powoduje, że zadanie kompilacji używa ścieżek bezwzględnych dla wszystkich plików zgłoszonych w komunikacie o błędzie. |
| Satellite_LinkResource | .SIEĆ | Łączy określone pliki zasobów z zestawem satelitarnym. |
| Satellite_MainEntryPoint | .SIEĆ | Określa w pełni kwalifikowaną nazwę (czyli class.method) metody, która ma być używana jako punkt wejścia, gdy moduł jest konwertowany na plik wykonywalny podczas generowania zestawu satelitarnego. |
| Satellite_ProductName | .SIEĆ | Określa ciąg pola Product w zestawie satelitarnym. |
| Satellite_ProductVersion | .SIEĆ | Określa ciąg pola ProductVersion w zestawie satelitarnym. |
| Satellite_TargetType | .SIEĆ | Określa format pliku wyjściowego zestawu satelitarnego jako "biblioteka", "exe" lub "win". Wartość domyślna to "biblioteka". |
| Satellite_Title | .SIEĆ | Określa ciąg pola Title w zestawie satelitarnym. |
| Satellite_Trademark | .SIEĆ | Określa ciąg dla pola Znak towarowy w zestawie satelitarnym. |
| Satellite_Version | .SIEĆ | Określa informacje o wersji zestawu satelitarnego. |
| Satellite_Win32Icon | .SIEĆ | Wstawia plik ikony .ico do zestawu satelitarnego. |
| Satellite_Win32Resource | .SIEĆ | Wstawia zasób Win32 (plik.res) do zestawu satelitarnego. |
| SGenToolPath | .SIEĆ | Opcjonalna ścieżka narzędzia wskazująca, gdzie uzyskać SGen.exe po zastąpieniu bieżącej wersji SGen.exe. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| SGenUseProxyTypes | .SIEĆ | Wartość logiczna wskazująca, czy typy serwerów proxy powinny być generowane przez SGen.exe. Ma to zastosowanie tylko wtedy, gdy GenerateSerializationAssemblies jest ustawiona na włączone. Obiekt docelowy SGen używa tej właściwości do ustawienia flagi UseProxyTypes. Ta właściwość jest domyślnie ustawiona na true i nie ma interfejsu użytkownika do zmiany. Aby wygenerować zestaw serializacji dla typów innych niż webservice, dodaj tę właściwość do pliku projektu i ustaw ją na wartość false przed zaimportowaniem Microsoft.Common.Targets lub C#/VB.targets. |
| SkipInvalidConfigurations | Cały | Gdy true, wygeneruj ostrzeżenie dotyczące nieprawidłowych kombinacji platformy i konfiguracji, ale nie kończy się niepowodzeniem kompilacji; gdy false lub niezdefiniowane (wartość domyślna), wygeneruj błąd. |
| StartupObject | .SIEĆ | Określa klasę lub moduł, który zawiera metodę Main lub procedurę podrzędną. Ta właściwość jest równoważna przełącznikowi kompilatora /main. |
| PodsystemVersion | .SIEĆ | Określa minimalną wersję podsystemu, z którego może korzystać wygenerowany plik wykonywalny. Ta właściwość jest równoważna przełącznikowi kompilatora /subsystemversion. Aby uzyskać informacje o wartości domyślnej tej właściwości, zobacz /subsystemversion (Visual Basic) lub /subsystemversion (opcje kompilatora języka C#). |
| TargetCompactFramework | .SIEĆ | Wersja platformy .NET Compact Framework wymagana do uruchomienia kompilowania aplikacji. Określenie tej opcji umożliwia odwoływanie się do niektórych zestawów platformowych, do których może się odwoływać w przeciwnym razie. |
| TargetFrameworkVersion | .SIEĆ | Wersja programu .NET Framework wymagana do uruchomienia kompilowania aplikacji. Określenie tej opcji umożliwia odwoływanie się do niektórych zestawów platformowych, do których może się odwoływać w przeciwnym razie. |
| TreatWarningsAsErrors | .SIEĆ | Parametr logiczny, który, jeśli true, powoduje, że wszystkie ostrzeżenia będą traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /nowarn. |
| UseCommonOutputDirectory | .SIEĆ | Właściwość logiczna, którą można ustawić na true, gdy chcesz, aby wszystkie dane wyjściowe kompilacji w rozwiązaniu używały tego samego katalogu wyjściowego. Jeśli true, dane wyjściowe przywoływanego projektu nie są kopiowane do projektów korzystających z tych zależności, tak jak zwykle w przypadku, gdy to ustawienie jest false. Ustawienie tego parametru na true nie powoduje zmiany rzeczywistego katalogu wyjściowego żadnych projektów; Nadal musisz ustawić katalog wyjściowy na żądany wspólny katalog wyjściowy dla każdego projektu, który go wymaga. |
| UseHostCompilerIfAvailable | .SIEĆ | Parametr logiczny, który, jeśli true, powoduje, że zadanie kompilacji używa obiektu kompilatora w procesie, jeśli jest dostępne. Ten parametr jest używany tylko przez program Visual Studio. |
| Utf8Output | .SIEĆ | Parametr logiczny, który, jeśli true, rejestruje dane wyjściowe kompilatora przy użyciu kodowania UTF-8. Ten parametr jest odpowiednikiem przełącznika kompilatora /utf8Output. |
| Nazwa właściwości lub parametru | Typy projektów | Opis |
|---|---|---|
| VbcToolPath | Visual Basic | Opcjonalna ścieżka wskazująca inną lokalizację dla vbc.exe, gdy jest zastępowana bieżąca wersja vbc.exe. |
| VbcVerbosity | Visual Basic | Określa szczegółowość danych wyjściowych kompilatora Języka Visual Basic. Prawidłowe wartości to "Cichy", "Normalny" (wartość domyślna) lub "Pełne". |
| VisualStudioVersion | Cały | Określa wersję programu Visual Studio, w ramach której ten projekt powinien być uznawany za uruchomiony. Jeśli ta właściwość nie jest określona, program MSBuild ustawia ją na wartość domyślną {VisualStudioMajorVersion}.0; na przykład zostanie 17.0 dla wszystkich wersji programu Visual Studio 2022.Ta właściwość jest używana w kilku typach projektów, aby określić zestaw obiektów docelowych używanych do kompilacji. Jeśli ToolsVersion jest ustawiona na 4.0 lub nowszą dla projektu, VisualStudioVersion służy do określania zestawu narzędzi podrzędnych do użycia. Aby uzyskać więcej informacji, zobacz Toolset (ToolsVersion). |
| WarningsAsErrors | .SIEĆ | Określa listę ostrzeżeń, które mają być traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /warnaserror. |
| OstrzeżeniePoszczel | Cały | Określa poziom ostrzeżenia, który ma być przekazywany do kompilatorów dla ostrzeżeń emitowanych przez kompilator. To ustawienie nie ma wpływu na ostrzeżenia programu MSBuild, które nie mają oznaczeń poziomu. Zobacz poziom ostrzeżenia w dokumentacji kompilatora języka C# i /W (poziom ostrzeżenia) w dokumentacji kompilatora języka C++. |
| WarningsNotAsErrors | .SIEĆ | Określa listę ostrzeżeń, które nie są traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /warnaserror. |
| Win32Manifest | .SIEĆ | Nazwa pliku manifestu, który powinien być osadzony w ostatnim zestawie. Ten parametr jest odpowiednikiem przełącznika kompilatora /win32Manifest. |
| Win32Resource | .SIEĆ | Nazwa pliku zasobu Win32, który ma być osadzony w ostatnim zestawie. Ten parametr jest odpowiednikiem przełącznika kompilatora /win32resource. |
Właściwości specyficzne dla projektów zestawu .NET SDK, takich jak TargetFramework, są udokumentowane we właściwościach programu Framework.
Zobacz też
- typowe elementy projektu MSBuild
- typowe metadane elementu MSBuild
- właściwości zarezerwowanych i dobrze znanych
- dokumentacja programu MSBuild dla projektów zestawu .NET SDK