Wspólne właściwości projektu MSBuild

Następująca tabela zawiera listę często używane właściwości, które są zdefiniowane w plikach projektu programu Visual Studio lub zawarte w plikach .targets, które dostarcza program MSBuild.

Pliki projektu w programie Visual Studio (.csproj, .vbproj, vcxproj i inne) zawierają kod programu MSBuild XML, który jest uruchamiany podczas tworzenia projektu przy użyciu IDE.Projekty zwykle zaimportować jeden lub więcej plików .targets, aby zdefiniować ich proces kompilacji.Aby uzyskać więcej informacji, zobacz Program MSBuild.Pliki z obiektami docelowymi.

Lista typowych właściwości i parametrów

Właściwość lub nazwę parametru	Opis
AdditionalLibPaths	Określa dodatkowe foldery, w których kompilatory należy szukać zestawów odwołań.
AddModules	Powoduje, że kompilator typu wszystkich informacji z określonego pliki dostępne do projektu, kompilacja.Ta właściwość jest równoważne z /addModules przełącznik kompilatora.
ALToolPath	Ścieżka, w której można znaleźć AL.exe.Właściwość ta zastępuje bieżącej wersji programu AL.exe w celu umożliwienia korzystania z innej wersji.
ApplicationIcon	.ico ikonę pliku do kompilator do osadzania jako ikona Win32.Właściwość jest równoważne z /win32icon przełącznik kompilatora.
ApplicationManifest	Określa ścieżkę pliku, który jest używany do generowania zewnętrznych informacje o liście Kontrola konta użytkownika (UAC).Ma zastosowanie tylko do projektów programu Visual Studio-określanie wartości docelowej Windows Vista. W większości przypadków manifest jest osadzony.Jednakże jeśli używasz wolnego COM rejestracji lub ClickOnce wdrażania, a następnie manifest może być pliku zewnętrznego, który jest instalowany razem z swoje zestawy aplikacji.Aby uzyskać więcej informacji zobacz właściwość NoWin32Manifest w tym temacie.
AssemblyOriginatorKeyFile	Określa plik, który jest używany do podpisywania zestawu (.snk lub pfx) i która jest przekazywana do Zadanie ResolveKeySource do generowania rzeczywistego klucza, który jest używany do podpisywania zestawu.
AssemblySearchPaths	Listę lokalizacji, do wyszukiwania podczas rezolucję Zgromadzenia odniesienia czas montażu.Kolejność wyświetlania ścieżek na tej liście jest znaczące, ponieważ ścieżki wymienione wcześniej ma pierwszeństwo przed później wpisów.
AssemblyName	Nazwa zestawu końcowych danych wyjściowych, po zbudowaniu projektu.
BaseAddress	Określa adres bazowy Zgromadzenia głównego produktu.Ta właściwość jest równoważne z /baseaddress przełącznik kompilatora.
BaseOutputPath	Określa ścieżki bazowej dla pliku wyjściowego.Jeżeli jest ustawiony, MSBuild użyje OutputPath = $(BaseOutputPath)\$(Configuration)\.Przykładowa składnia:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BaseIntermediateOutputPath	Folder najwyższego poziomu, gdzie tworzone są wszystkie foldery specyficzne dla konfiguracji pośredni na wyjściu.Wartością domyślną jest obj\.Poniższy kod jest przykładem:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
BuildInParallel	Wartość logiczna, wskazująca, czy odwołania są budowane lub czyszczone w równoległych, kiedy obsługi wielu MSBuild jest używana.Wartością domyślną jest true, co oznacza, że projekty zostanie zbudowana w równoległych, jeśli system ma wiele rdzeni lub przetwórców.
BuildProjectReferences	Wartość logiczna, wskazująca, czy odwołania są pisane przez MSBuild.Ustaw false w przypadku budowania projektu Visual Studio zintegrowane środowisko programistyczne (IDE), true Jeśli inaczej.
CleanFile	Nazwa pliku, który będzie używany jako "cache czyste." Czyste pamięć podręczna jest wykaz wygenerowane pliki do usunięcia podczas operacji czyszczenia.Plik jest umieszczana w ścieżki wyjściowej pośrednie przez proces kompilacji. Właściwość ta określa tylko nazwy plików, które nie mają informacji o ścieżce.
Strona kodowa	Określa stronę kodową dla wszystkich plików kodu źródłowego w kompilacji.Ta właściwość jest równoważne z /codepage przełącznik kompilatora.
CompilerResponseFile	Plik odpowiedzi opcjonalne, które mogą być przekazywane do zadań kompilatora.
Konfiguracja	Konfiguracji, który tworzysz, "Debug" lub "Zwolnij".
CscToolPath	Ścieżka csc.exe, Visual C# kompilatora.
CustomBeforeMicrosoftCommonTargets	Nazwa pliku projektu lub elementy docelowe pliku, który ma być zaimportowany automatycznie przed rozpoczęciem wspólnej importowania obiektów docelowych.
DebugSymbols	Wartość logiczna wskazująca, czy symbole są generowane przez kompilacji. Ustawienie /p:DebugSymbols=false w wierszu polecenia wyłącza generowanie pliki symboli (.pdb) bazy danych programu.
DefineConstants	Definiuje stałe warunkowego kompilatora.Pary symbol i wartości są oddzielone średnikami i są określane za pomocą następującej składni: symbol1 = wartość1; Symbol2 = value2 Właściwość jest równoważne z /define przełącznik kompilatora.
DefineDebug	Wartość logiczna wskazująca, czy chcesz, aby definicja stała debugowania.
DefineTrace	Wartość logiczna wskazująca, czy chcesz, aby definicja stała śledzenia.
DebugType	Definiuje poziom informacji debugowania, który ma zostać wygenerowany.Prawidłowe wartości to "Pełna," "" pdbonly "" i "none.
DelaySign	Wartość logiczna wskazująca, czy użytkownik chce opóźnienie podpisuje zestaw z, a nie pełny znak go.
DisabledWarnings	Pomija ostrzeżenia określony.Musi być określona tylko numeryczne częścią identyfikatora ostrzeżenie.Wiele ostrzeżeń są oddzielone średnikami.Ten parametr odnosi się do /nowarn przełącznik kompilatora vbc.exe.
DisableFastUpToDateCheck	Wartość logiczna, która ma zastosowanie do Visual Studio tylko.Visual Studio Zbudować używa Menedżera procesu o nazwie FastUpToDateCheck, aby ustalić, czy projekt musi zostać odbudowany być na bieżąco.Ten proces jest szybsze niż użycie MSBuild do jego określenia.Ustawienie właściwości DisableFastUpToDateCheck na true pozwala ominąć Visual Studio zbudować menedżera i zmusić go do używania MSBuild do określenia, czy projekt jest aktualny.
DocumentationFile	Nazwa pliku, który zostanie wygenerowany jako plik dokumentacji XML.Nazwa ta zawiera tylko nazwę pliku i nie ma ścieżki informacji.
ErrorReport	Określa, jak zadanie kompilator powinien zgłosić wewnętrzne błędy kompilatora.Prawidłowe wartości to "monit", "Wyślij" lub "none. Ta właściwość jest równoważne z /errorreport przełącznik kompilatora.
ExcludeDeploymentUrl	Zadanie GenerateDeploymentManifest Dodaje deploymentProvider tag do rozmieszczenia oczywiste, jeśli plik projektu zawiera dowolne z następujących elementów: UpdateUrl InstallUrl PublishUrl Korzystając z ExcludeDeploymentUrl, jednak można zapobiec deploymentProvider tag zostaną dołączone do rozmieszczenia oczywiste, nawet jeśli są określone powyżej adresów URL. Aby to zrobić, należy dodać do pliku projektu następującą właściwość: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Uwaga ExcludeDeploymentUrl nie jest dostępny w Visual Studio IDE i można ustawić tylko przez ręczną edycję pliku projektu. Ustawienie tej właociwooci nie wpływa na publikowanie w ramach Visual Studio; oznacza to, że znacznik deploymentProvider nadal zostanie dodany adres URL określony w PublishUrl.
FileAlignment	Określa w bajtach, gdzie można wyrównać w sekcjach pliku wyjściowego.Poprawne argumenty znacznika to: 512, 1024, 2048, 4096, 8192.Ta właściwość jest równoważne z /filealignment przełącznik kompilatora.
FrameworkPathOverride	Określa lokalizację mscorlib.dll i microsoft.visualbasic.dll.Ten parametr jest równoważne z /sdkpath przełącznik kompilatora vbc.exe.
GenerateDocumentation	Parametrów typu boolean, która wskazuje, czy dokumentacja jest generowana przez osadzanie.Jeśli true, budowanie generuje informacje o dokumentacji i umieszcza go w postaci pliku XML wraz z nazwą pliku wykonywalnego lub biblioteki, które utworzone zadanie kompilacji.
IntermediateOutputPath	Ścieżki wyjściowej pełne pośrednich, zaczerpniętej z BaseIntermediateOutputPath, jeśli nie określono ścieżki.Na przykład \obj\debug\.Jeśli właściwość ta zostanie zastąpiona, a następnie ustawienie BaseIntermediateOutputPath nie ma wpływu.
NazwaKonteneraKlucza	Nazwa kontenera klucza silnej nazwy.
KeyOriginatorFile	Nazwa pliku klucza silnej nazwy.
NoWin32Manifest	Określa, czy kompilator generuje manifest Win32 domyślnej do zestawu danych wyjściowych.Wartość domyślna false oznacza, że manifest Win32 domyślny jest generowany dla wszystkich aplikacji.Ta właściwość jest równoważne z /nowin32manifest przełącznik kompilatora vbc.exe.
ModuleAssemblyName	Nazwa zestawu, który moduł skompilowany jest należy uwzględnić.Właściwość jest równoważne z /moduleassemblyname przełącznik kompilatora.
NoLogo	Wartość logiczna, która wskazuje, czy kompilator logo jest wyłączony.Ta właściwość jest równoważne z /nologo przełącznik kompilatora.
NoStdLib	Wartość logiczna wskazująca, czy w celu uniknięcia odwoływania się do biblioteki standardowej (mscorlib.dll).Wartością domyślną jest false.
NoVBRuntimeReference	Wartość logiczna, wskazująca, czy Visual Basic runtime (Microsoft.VisualBasic.dll) powinny być zawarte jako odwołanie w projekcie.
NoWin32Manifest	Wartość logiczna, wskazująca, czy informacje o liście Kontrola konta użytkownika (UAC) zostaną osadzone w aplikacji użytkownika pliku wykonywalnego.Ma zastosowanie tylko do projektów programu Visual Studio-określanie wartości docelowej Windows Vista.W projektach wdrożyć za pomocą ClickOnce i bez rejestracji COM, ten element jest ignorowany. False(wartość domyślna) określa, że kontrola konta użytkownika (UAC) informacje osadzone w pliku wykonywalnego aplikacji.TrueOkreśla, że informacje o liście funkcji Kontrola konta użytkownika nie można osadzić. Właściwość ta ma zastosowanie tylko do Visual Studio projekty-określanie wartości docelowej Windows Vista.W projektach wdrożyć za pomocą ClickOnce i bez rejestracji COM, ta właściwość jest ignorowana. Należy dodać NoWin32Manifest, tylko wtedy, gdy nie chcesz Visual Studio osadzenie wszelkie manifest informacji we wniosku jest wykonywalny; Ten proces jest nazywany virtualization.Aby korzystać z wirtualizacji, należy ustawić <ApplicationManifest> w połączeniu z <NoWin32Manifest> się następujące zmiany: Dla Visual Basic usunąć projektów, <ApplicationManifest> węzła.(W Visual Basic projektów, <NoWin32Manifest> jest ignorowane kiedy <ApplicationManifest> węzeł istnieje.) For Visual C# projects, set <ApplicationManifest> to False and <NoWin32Manifest> to True.(In Visual C# projects, <ApplicationManifest> overrides <NoWin32Manifest>.)
Optymalizuj	Wartość logiczna wartość ustawiona na wartość true, umożliwia optymalizacje kompilatora.Ta właściwość jest równoważne z /optimize przełącznik kompilatora.
OptionCompare	Określa, jak porównania ciągu.Prawidłowe wartości to "binary" lub "tekst". Ta właściwość jest równoważne z /optioncompare przełącznik kompilatora vbc.exe.
OptionExplicit	Wartość logiczna wartość ustawiona na wartość true, wymaga jawnej deklaracji zmiennych w kodzie źródłowym.Ta właściwość jest równoważne z /optionexplicit przełącznik kompilatora.
OptionInfer	Wartość logiczna wartość ustawiona na wartość true, umożliwia wpisz wnioskowanie zmiennych.Ta właściwość jest równoważne z /optioninfer przełącznik kompilatora.
OptionStrict	Wartość logiczna wartość ustawiona na wartość true, powoduje, że zadanie kompilacji do wymuszania semantykę ścisłe zasady do ograniczenia niejawne konwersje typów.Ta właściwość jest równoważne z /optionstrict przełącznik kompilatora vbc.exe.
OutputPath	Określa ścieżkę do katalogu wyjściowego, względem katalogu projektu, na przykład "bin\Debug".
OutputType	Określa format pliku w postaci pliku wyjściowego.Ten parametr może mieć jeden z następujących wartości: Biblioteka.Tworzy bibliotekę kodu.(Wartość domyślna). Exe.Tworzy aplikację konsoli. Moduł.Tworzy moduł. Winexe.Tworzy program oparty na systemie Windows. Ta właściwość jest równoważne z /target przełącznik kompilatora vbc.exe.
OverwriteReadOnlyFiles	Wartość logiczna wskazująca, czy chcesz włączyć kompilacji do zastąpienia plików tylko do odczytu lub wyzwolić błąd.
PdbFile	Nazwa pliku plik .pdb, które są wysyłających.Ta właściwość jest równoważne z /pdb przełącznik kompilatora csc.exe.
Platforma	System operacyjny, który tworzysz dla.Prawidłowe wartości to "AnyCPU", "x 86", "x 64" lub "Itanium".
RemoveIntegerChecks	Wartość logiczna wskazująca, czy należy wyłączyć sprawdzaniu błędów przepełnienie liczby całkowitej.Wartością domyślną jest false.Ta właściwość jest równoważne z /removeintchecks przełącznik kompilatora vbc.exe.
SGenUseProxyTypes	Wartość logiczna wskazująca, czy typy serwera proxy powinny być generowane przez SGen.exe. Obiekt docelowy SGen używa tej właściwości z określoną flagą UseProxyTypes.Domyślnie przyjmuje wartość true tej właściwości, a nie ma żadnych interfejsu użytkownika, aby to zmienić.Aby wygenerować zestawu serializacji dla typów usługa sieci Web, należy dodać tę właściwość do pliku projektu i ustawi wartość false przed importowaniem Microsoft.Common.Targets lub C#/VB.targets.
SGenToolPath	Ścieżka opcjonalne narzędzie, która wskazuje, gdzie w celu uzyskania SGen.exe, gdy jest zastępowane bieżącą wersję SGen.exe.
StartupObject	Określa class lub module, który zawiera metody Main lub procedura Sub Main.Ta właściwość jest równoważne z /main przełącznik kompilatora.
Badanie elementu ProcessorArchitecture	Architektura procesora, który jest używany podczas odwołania do zestawów nie są rozwiązane.Prawidłowe wartości to "msil", "x 86", "amd64" lub "ia64."
RootNamespace	Obszaru nazw root, aby użyć nazwy zasobów osadzonych.Ten obszar nazw jest częścią nazwy manifestu zasobów osadzonych.
Satellite_AlgorithmId	Identyfikator algorytmu mieszania AL.exe do użycia podczas zestawy satelickie są tworzone.
Satellite_BaseAddress	Adres bazowy używany podczas specyficzne dla kultury zestawy satelickie są zbudowane przy użyciu CreateSatelliteAssemblies miejsce docelowe.
Satellite_CompanyName	Nazwa firmy do przekazania do AL.exe podczas generowania zestawu satelitarnego.
Satellite_Configuration	Nazwa konfiguracji do przekazania do AL.exe podczas generowania zestawu satelitarnego.
Satellite_Description	Tekst opisu do przekazania do AL.exe podczas generowania zestawu satelitarnego.
Satellite_EvidenceFile	Osadza określony plik w zestawu satelickiego, który ma nazwę zasobu "Security.Evidence".
Satellite_FileVersion	Określa ciąg dla pola wersja pliku w zestawu satelickiego.
Satellite_Flags	Określa wartość dla pola flag w zestawu satelickiego.
Satellite_GenerateFullPaths	Powoduje, że zadanie kompilacji do użycia ścieżki bezwzględne dla wszelkich plików, zgłaszane w komunikacie o błędzie.
Satellite_LinkResource	Łączy pliki zasobów określonego zestawu satelickiego.
Satellite_MainEntryPoint	Określa pełną nazwę (czyli class.method) metodę ma być używana jako punkt wejścia moduł jest konwertowany na plik wykonywalny podczas generowania zestawu satelitarnego.
Satellite_ProductName	Określa ciąg dla pola produkt w zestawu satelickiego.
Satellite_ProductVersion	Określa ciąg dla pola ProductVersion w zestawu satelickiego.
Satellite_TargetType	Określa format pliku, pliku wynikowego zestawu satelitarnego jako "Biblioteka", "exe," lub "kot". Wartością domyślną jest "Biblioteka".
Satellite_Title	Określa ciąg w polu Tytuł w zestawu satelickiego.
Satellite_Trademark	Określa ciąg dla pola znaku towarowego w zestawu satelickiego.
Satellite_Version	Określa informacje o wersji dla zestawu.
Satellite_Win32Icon	Wstawia plik .ico ikony zestawu satelickiego.
Satellite_Win32Resource	Wstawia zasobów Win32 (.res plik) do zestawu.
SubsystemVersion	Określa minimalną wersję podsystemu, który można użyć wygenerowany plik wykonywalny.Ta właściwość jest równoważne z /subsystemversion przełącznik kompilatora.Aby uzyskać informacje dotyczące wartością domyślną tej właściwości, zobacz /subsystemversion (Visual Basic) lub /subsystemversion (C# kompilator opcje).
TargetCompactFramework	Wersja platformy .NET Compact Framework, który jest wymagany do uruchamiania aplikacji, która jest konstruowany.Określenie tej pozwala odwołuje się do niektórych zestawów framework, które mogą nie być można odwoływać się w inny sposób.
TargetFrameworkVersion	Wersja .NET Framework jest to wymagane do uruchamiania aplikacji, która jest konstruowany.Określenie tej pozwala odwołuje się do niektórych zestawów framework, które mogą nie być można odwoływać się w inny sposób.
TreatWarningsAsErrors	Parametrów typu boolean, jeśli true, powoduje, że wszystkie ostrzeżenia były traktowane jako błędy.Ten parametr jest równoważne z /nowarn przełącznik kompilatora.
UseHostCompilerIfAvailable	Parametrów typu boolean, jeśli true, powoduje, że zadanie kompilacji do korzystania z obiektu wewnątrzprocesowego kompilatora, jeśli jest on dostępny.Ten parametr jest używany tylko przez Visual Studio.
Utf8Output	Parametrów typu boolean, jeśli true, rejestruje dane wyjściowe kompilatora przy użyciu kodowania UTF-8.Ten parametr jest równoważne z /utf8Output przełącznik kompilatora.
VbcToolPath	Opcjonalna ścieżka, która wskazuje inną lokalizację dla vbc.exe, gdy bieżąca wersja vbc.exe zostanie zastąpiona.
VbcVerbosity	Określa poziom szczegółowości Visual Basic dane wyjściowe kompilatora.Prawidłowe wartości to "Cichy", "Normalny" (wartość domyślna) lub "Pełne."
VisualStudioVersion	Określa numer wersji programu Visual Studio, pod którym tego projektu należy uznać za działały.Jeśli ta właściwość nie jest określony, program MSBuild ustawia ją na wartość standardową. Ta właściwość jest używana w kilku typów projektów, aby określić zestaw obiektów docelowych, które są używane dla kompilacji.Jeśli ToolsVersion jest zestaw 4.0 lub wyższej dla projektu, VisualStudioVersion jest używana do określenia, które toolset sub, aby użyć.Aby uzyskać więcej informacji, zobacz Zestaw narzędzi MSBuild (ToolsVersion).
WarningsAsErrors	Określa listę ostrzeżeń jako błędy.Ten parametr jest równoważne z /warnaserror przełącznik kompilatora.
WarningsNotAsErrors	Określa listę ostrzeżeń, które nie są traktowane jako błędy.Ten parametr jest równoważne z /warnaserror przełącznik kompilatora.
Win32Manifest	Nazwa pliku manifestu, które powinny być osadzone w montażu produktu końcowego.Ten parametr jest równoważne z /win32Manifest przełącznik kompilatora.
Wint32Resource	Nazwa pliku zasobów Win32 do osadzenia się przy składaniu ostatecznej wersji.Ten parametr jest równoważne z /win32resource przełącznik kompilatora.

Zobacz też

Informacje

Wspólne elementy projektu MSBuild