Wspólne właściwości projektów 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 docelowych dostępnych w programie MSBuild.
Pliki projektu w programie Visual Studio (csproj, vbproj, .vcxproj i inne) zawierają kod XML programu MSBuild uruchamiany podczas tworzenia projektu przy użyciu środowiska IDE. Projekty zazwyczaj importują jeden lub więcej plików docelowych w celu zdefiniowania procesu kompilacji. Aby uzyskać więcej informacji, zobacz pliki .targets programu MSBuild.
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 pliku Directory.Build.props lub w innym zaimportowanym pliku. Jeśli ustawiasz właściwość gdzieś i nie otrzymujesz oczekiwanego wyniku, rozważ, gdzie i w jaki sposób 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 (zobacz /preprocess opcję wiersza polecenia lub /pp w dokumentacji wiersza polecenia MSBuild).
Lista typowych właściwości i parametrów
| Nazwa właściwości lub parametru | Typy projektu | opis |
|---|---|---|
| AdditionalLibPaths | .NET | Określa dodatkowe foldery, w których kompilatory powinny szukać zestawów odwołań. |
| Tryby dodawania | .NET | 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 | .NET | Ścieżka do AL.exe. Ta właściwość zastępuje bieżącą wersję AL.exe , aby umożliwić korzystanie z innej wersji. |
| ApplicationIcon | .NET | Plik ikony .ico , który ma być przekazywany do kompilatora na potrzeby osadzania jako ikona Win32. Właściwość jest równoważna przełącznikowi kompilatora /win32icon . |
| ApplicationManifest | wszystkie | 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 | .NET | Określa plik używany do podpisania zestawu (.snk lub .pfx) i jest przekazywany do zadania ResolveKeySource w celu wygenerowania rzeczywistego klucza użytego do podpisania zestawu. |
| AssemblySearchPaths | .NET | 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 | .NET | Nazwa końcowego zestawu wyjściowego po skompiluj projekt. |
| Nazwa właściwości lub parametru | Typy projektu | opis |
|---|---|---|
| BaseAddress | .NET | Określa adres podstawowy głównego zestawu wyjściowego. Ta właściwość jest równoważna przełącznikowi kompilatora /baseaddress . |
| BaseIntermediateOutputPath | wszystkie | Folder najwyższego poziomu, w którym są tworzone wszystkie foldery wyjściowe pośrednie specyficzne dla konfiguracji. Domyślna wartość to obj\. Poniższy kod jest przykładem: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | wszystkie | Określa ścieżkę podstawową dla pliku wyjściowego. Jeśli jest ustawiona, program MSBuild używa polecenia OutputPath = $(BaseOutputPath)\$(Configuration)\. Przykładowa składnia: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | wszystkie | 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ą tworzone równolegle, jeśli system ma wiele rdzeni lub procesorów. |
| BuildProjectReferences | wszystkie | Wartość logiczna wskazująca, czy odwołania do projektu są kompilowane przez program MSBuild. Automatycznie ustaw wartość w false przypadku kompilowania projektu w zintegrowanym środowisku projektowym (IDE) programu Visual Studio, true jeśli 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 projektu | opis |
|---|---|---|
| CleanFile | wszystkie | 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 | .NET | 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 | .NET | Opcjonalny plik odpowiedzi, który można przekazać do zadań kompilatora. |
| Konfigurowanie | wszystkie | Konfiguracja, którą tworzysz, ogólnie Debug lub Release, ale można skonfigurować na poziomie rozwiązania i projektu. |
| CscToolPath | C# | Ścieżka csc.exe— kompilator języka C#. |
| CustomAfterMicrosoftCommonTargets | wszystkie | Nazwa pliku projektu lub pliku docelowej, który ma zostać zaimportowany automatycznie po zaimportowaniu wspólnych obiektów docelowych. |
| CustomBeforeMicrosoftCommonTargets | wszystkie | 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 projektu | opis |
|---|---|---|
| DebugSymbols | wszystkie | Wartość logiczna wskazująca, czy symbole są generowane przez kompilację. Ustawienie -p:DebugSymbols=false w wierszu polecenia wyłącza generowanie plików symboli bazy danych programu (.pdb). |
| Typ debugowania | wszystkie | Definiuje poziom informacji debugowania, które chcesz wygenerować. Prawidłowe wartości to "full", "pdbonly", "portable", "embedded" i "none". |
| DefineConstants | .NET | 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 | wszystkie | Wartość logiczna wskazująca, czy chcesz zdefiniować stałą DEBUG. |
| DefineTrace | wszystkie | Wartość logiczna wskazująca, czy chcesz zdefiniować stałą TRACE. |
| DelaySign | .NET | Wartość logiczna wskazująca, czy chcesz opóźnić podpisywanie zestawu, a nie pełnego podpisywania. |
| Deterministyczny | .NET | Wartość logiczna wskazująca, czy kompilator powinien produkować identyczne zestawy dla identycznych danych wejściowych. Ten parametr odpowiada /deterministic przełącznikowi kompilatorów. |
| DirectoryBuildPropsPath | wszystkie | 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 | wszystkie | Określa ścieżkę do pliku Directory.Build.targets ; jeśli jest zdefiniowana, ta właściwość zastępuje domyślny algorytm wyszukiwania. Zobacz Dostosowywanie kompilacji. |
| DisableFastUpToDateCheck | wszystkie | 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 w celu true obejścia menedżera kompilacji programu Visual Studio i wymuszenia użycia programu MSBuild w celu określenia, czy projekt jest aktualny. |
| DocumentationFile | .NET | 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 projektu | opis |
|---|---|---|
| Raport o błędach | .NET | 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 | .NET | 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: element ExcludeDeploymentUrl nie jest uwidaczniony w środowisku IDE programu Visual Studio i można go 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 | .NET | 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 /sdkpath przełącznika kompilatora vbc.exe . |
| GenerateDocumentationFile | .NET | Parametr logiczny wskazujący, czy dokumentacja jest generowana przez kompilację. Jeśli truekompilacja 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 | .NET | 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, należy odwołać się do pakietu NuGet Microsoft.XmlSerializer.Generator . |
| Nazwa właściwości lub parametru | Typy projektu | opis |
|---|---|---|
| ImportDirectoryBuildProps | wszystkie | Wartość logiczna wskazująca, czy zaimportować plik Directory.Build.props . Zobacz Dostosowywanie kompilacji. |
| ImportDirectoryBuildTargets | wszystkie | Wartość logiczna wskazująca, czy zaimportować plik Directory.Build.targets . Zobacz Dostosowywanie kompilacji. |
| IntermediateOutputPath | wszystkie | Pełna ścieżka danych wyjściowych pośrednich pochodząca z BaseIntermediateOutputPathparametru , jeśli nie określono żadnej ścieżki. Na przykład obj\debug\. |
| KeyContainerName | wszystkie | Nazwa kontenera klucza o silnej nazwie. |
| KeyOriginatorFile | wszystkie | Nazwa pliku klucza silnej nazwy. |
| ModuleAssemblyName | .NET | Nazwa zestawu, do którego ma zostać włączony skompilowany moduł. Właściwość jest równoważna przełącznikowi kompilatora /moduleassemblyname . |
| MSBuildProjectExtensionsPath | wszystkie | Określa ścieżkę, w której znajdują się rozszerzenia projektu. Domyślnie przyjmuje tę samą wartość co BaseIntermediateOutputPath. |
| MSBuildTreatWarningsAsErrors | wszystkie | Wartość logiczna, która nakazuje programowi MSBuild traktowanie wszystkich ostrzeżeń jako błędów, chyba że zostaną pominięte. |
| MSBuildWarningsAsErrors | wszystkie | 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 WarningsAsErrorszestawu .NET SDK, MSBuildWarningsAsErrors wartość domyślna to WarningsAsErrors. |
| MSBuildWarningsAsMessages | wszystkie | 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 -warnAsMessagewiersza polecenia . Jeśli używasz właściwości NoWarnzestawu .NET SDK, MSBuildWarningsAsMessages wartość domyślna to NoWarn. |
| Nazwa właściwości lub parametru | Typy projektu | opis |
|---|---|---|
| NoLogo | wszystkie | Wartość logiczna wskazująca, czy logo kompilatora ma być wyłączone. Ta właściwość jest równoważna przełącznikowi kompilatora /nologo . |
| NoStdLib | .NET | Wartość logiczna wskazująca, czy uniknąć odwoływania się do standardowej biblioteki (mscorlib.dll). Domyślna wartość to false. |
| NoVBRuntimeReference | Visual Basic | Wartość logiczna wskazująca, czy środowisko uruchomieniowe Visual Basic (Microsoft.VisualBasic.dll) powinno zostać uwzględnione jako odwołanie w projekcie. |
| NoWarn | .NET | Pomija określone ostrzeżenia. Należy określić tylko część liczbową identyfikatora ostrzeżenia. Wiele ostrzeżeń jest rozdzielonych średnikami. Ten parametr odpowiada /nowarn przełącznikowi kompilatorów. |
| NoWin32Manifest | .NET | 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 Com bez rejestracji ten element jest ignorowany. False (wartość domyślna) określa, że informacje o manifeście kontroli konta użytkownika (UAC) mają być 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 Com bez rejestracji 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 wirtualizacją. Aby użyć wirtualizacji, ustaw <ApplicationManifest> w połączeniu z <NoWin32Manifest> następującymi:— W przypadku projektów Visual Basic usuń <ApplicationManifest> węzeł. (W projektach Visual Basic jest ignorowany, <NoWin32Manifest> gdy <ApplicationManifest> węzeł istnieje).- W przypadku projektów języka C# ustaw wartość <ApplicationManifest> False i <NoWin32Manifest> na True. (W projektach <ApplicationManifest> języka C# przesłonięcia są zastępowane <NoWin32Manifest>).Ta właściwość jest równoważna przełącznikowi /nowin32manifest kompilatora vbc.exe. |
| Optymalizacja | .NET | Wartość logiczna ustawiona na truewartość , umoż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 /optioncompare kompilatora vbc.exe. |
| OptionExplicit | Visual Basic | Wartość logiczna ustawiona na true, wymaga 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 true, umożliwia wnioskowanie typów zmiennych. Ta właściwość jest równoważna przełącznikowi kompilatora /optioninfer . |
| OptionStrict | Visual Basic | Wartość logiczna ustawiona na true, powoduje, że zadanie kompilacji wymusza ścisłe semantyki typów w celu ograniczenia niejawnych konwersji typów. Ta właściwość jest równoważna /optionstrict przełącznikowi kompilatora vbc.exe . |
| OutDir | wszystkie | 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 | wszystkie | Określa ścieżkę do katalogu wyjściowego względem katalogu projektu, na przykład bin\Debug lub bin\Debug\$(Platforma) w kompilacjach innych niż AnyCPU. |
| OutputType | wszystkie | 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 set to WinExe for WPF and WinForms apps (Typ danych wyjściowych ustawionych na WinExe dla aplikacji WPF i WinForms). Wyłącz wnioskowanie, ustawiając wartość DisableWinExeOutputInference true. |
| ZastąpReadOnlyFiles | wszystkie | 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 projektu | opis |
|---|---|---|
| PathMap | .NET | 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 /pathmap przełącznikowi kompilatorów. |
| Plik PDB | .NET | Nazwa pliku .pdb , który emitujesz. Ta właściwość jest równoważna /pdb przełącznikowi kompilatora csc.exe . |
| Platforma | wszystkie | System operacyjny, dla którego tworzysz. Przykłady kompilacji programu .NET Framework to "Dowolne procesory CPU", "x86" i "x64". |
| ProcessorArchitecture | .NET | Architektura procesora używana podczas rozwiązywania odwołań do zestawów. Prawidłowe wartości to "msil", "x86", "amd64" lub "ia64". |
| ProduceOnlyReferenceAssembly | .NET | 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 /refonly przełącznikowi kompilatorów vbc.exe i csc.exe . |
| ProduceReferenceAssembly | .NET | Wartość logiczna, która po ustawieniu true umożliwia produkcję zestawów odwołań dla bieżącego zestawu. Deterministic powinna być true używana w przypadku korzystania z tej funkcji. Ta właściwość odpowiada /refout przełącznikowi kompilatorów vbc.exe i csc.exe . |
| RegisterAssemblyMSBuildArchitecture | Tylko 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 Windows | Wskazuje, że aplikacja zarządzana uwidacznia obiekt COM (otoka wywoływana com). Zobacz Stronę kompilacji — 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. Domyślna wartość to false. Ta właściwość jest równoważna /removeintchecks przełącznikowi kompilatora vbc.exe . |
| RootNamespace | wszystkie | 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 projektu | opis |
|---|---|---|
| Satellite_AlgorithmId | .NET | Identyfikator algorytmu tworzenia skrótów AL.exe używany podczas tworzenia zestawów satelickich. |
| Satellite_BaseAddress | .NET | Adres podstawowy używany podczas tworzenia zestawów satelitarnych specyficznych dla kultury przy użyciu CreateSatelliteAssemblies obiektu docelowego. |
| Satellite_CompanyName | .NET | Nazwa firmy do przekazania do AL.exe podczas generowania zestawów satelitarnych. |
| Satellite_Configuration | .NET | Nazwa konfiguracji, która ma być przekazywana do AL.exe podczas generowania zestawu satelitarnego. |
| Satellite_Description | .NET | Tekst opisu przekazywany do AL.exe podczas generowania zestawu satelitarnego. |
| Satellite_EvidenceFile | .NET | Osadza określony plik w zestawie satelitarnym o nazwie zasobu "Security.Evidence". |
| Satellite_FileVersion | .NET | Określa ciąg pola Wersja pliku w zestawie satelitarnym. |
| Satellite_Flags | .NET | Określa wartość pola Flags w zestawie satelitarnym. |
| Satellite_GenerateFullPaths | .NET | Powoduje, że zadanie kompilacji używa ścieżek bezwzględnych dla wszystkich plików zgłoszonych w komunikacie o błędzie. |
| Satellite_LinkResource | .NET | Łączy określone pliki zasobów z zestawem satelitarnym. |
| Satellite_MainEntryPoint | .NET | 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 | .NET | Określa ciąg pola Product w zestawie satelitarnym. |
| Satellite_ProductVersion | .NET | Określa ciąg pola ProductVersion w zestawie satelitarnym. |
| Satellite_TargetType | .NET | Określa format pliku wyjściowego zestawu satelitarnego jako "biblioteka", "exe" lub "win". Wartość domyślna to "biblioteka". |
| Satellite_Title | .NET | Określa ciąg pola Title w zestawie satelitarnym. |
| Satellite_Trademark | .NET | Określa ciąg dla pola Znak towarowy w zestawie satelitarnym. |
| Satellite_Version | .NET | Określa informacje o wersji zestawu satelitarnego. |
| Satellite_Win32Icon | .NET | Wstawia plik ikony .ico w zestawie satelitarnym. |
| Satellite_Win32Resource | .NET | Wstawia zasób Win32 (plik res ) do zestawu satelitarnego. |
| SGenToolPath | .NET | 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 projektu | opis |
|---|---|---|
| SGenUseProxyTypes | .NET | Wartość logiczna wskazująca, czy typy serwerów proxy powinny być generowane przez SGen.exe. Ma to zastosowanie tylko wtedy, gdy ustawienie GenerateSerializationAssemblies jest 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 nienależących do sieci Web, dodaj tę właściwość do pliku projektu i ustaw ją na wartość false przed zaimportowaniem obiektów Microsoft.Common.Targets lub C#/VB.targets. |
| SkipInvalidConfigurations | wszystkie | Gdy truewygeneruj ostrzeżenie dotyczące nieprawidłowych kombinacji platformy i konfiguracji, ale nie zakończ się niepowodzeniem kompilacji; gdy false lub niezdefiniowane (wartość domyślna), wygeneruj błąd. |
| StartupObject | .NET | 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 | .NET | 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 C#). |
| TargetCompactFramework | .NET | 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 | .NET | 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 | .NET | Parametr logiczny, który, jeśli true, powoduje, że wszystkie ostrzeżenia są traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /nowarn . |
| UseCommonOutputDirectory | .NET | Właściwość logiczna, którą można ustawić, true gdy chcesz, aby wszystkie dane wyjściowe kompilacji w rozwiązaniu używały tego samego katalogu wyjściowego. Jeśli trueelement , dane wyjściowe przywoływanego projektu nie są kopiowane do projektów korzystających z tych zależności, tak jak zwykle w przypadku tego ustawienia to false. Ustawienie tego parametru na true nie powoduje zmiany rzeczywistego katalogu wyjściowego jakichkolwiek projektów. Nadal musisz ustawić katalog wyjściowy na żądany wspólny katalog wyjściowy dla każdego projektu, który go wymaga. |
| UseHostCompilerIfAvailable | .NET | 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 | .NET | 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 projektu | 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 | wszystkie | Określa wersję programu Visual Studio, w ramach której ten projekt powinien być uznawany za uruchomiony. Jeśli ta właściwość nie zostanie określona, program MSBuild ustawi ją na wartość {VisualStudioMajorVersion}.0domyślną ; na przykład będzie 17.0 to wartość domyślna 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 dla projektu ustawiono wartość 4.0 lub nowszą, VisualStudioVersion służy do określania zestawu narzędzi podrzędnych do użycia. Aby uzyskać więcej informacji, zobacz Zestaw narzędzi (ToolsVersion). |
| WarningsAsErrors | .NET | Określa listę ostrzeżeń, które mają być traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /warnaserror . |
| OstrzeżeniePoszczel | wszystkie | 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 | .NET | Określa listę ostrzeżeń, które nie są traktowane jako błędy. Ten parametr jest odpowiednikiem przełącznika kompilatora /warnaserror . |
| Win32Manifest | .NET | Nazwa pliku manifestu, który powinien być osadzony w ostatnim zestawie. Ten parametr jest odpowiednikiem przełącznika kompilatora /win32Manifest . |
| Win32Resource | .NET | 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 platformy Framework.