Wspólne właściwości projektów MSBuild
Następująca tabela zawiera listę często używanych właściwości, które są zdefiniowane w plikach projekt programu Visual Studio lub zawartych w .targets plików, które zapewnia MSBuild.
Pliki projektu w programie Visual Studio (.csproj, .vbproj, vcxproj i inne) zawiera kod MSBuild XML, który jest uruchamiany podczas tworzenia projektu za pomocą środowiska IDE.Projekty zwykle zaimportować jeden lub więcej plików .targets do definiowania procesu kompilacji.Aby uzyskać więcej informacji, zobacz MSBuild — Pliki .Targets.
Lista typowych właściwości i parametrów
Właściwości lub nazwa parametru |
Opis |
|---|---|
AdditionalLibPaths |
Określa dodatkowe foldery, w których kompilatorów należy szukać zestawów odwołań. |
AddModules |
Powoduje, że kompilator dokonanie typu wszystkie informacje z określonego plików dostępnych do projektu, kompilacja.Ta właściwość jest odpowiednikiem /addModules przełącznik. |
ALToolPath |
Ścieżka, gdzie można znaleźć AL.exe.Ta właściwość zastępuje bieżącej wersji programu AL.exe, aby umożliwić stosowanie różnych wersji. |
ApplicationIcon |
Plik ikony .ico do przekazania do kompilatora dla osadzanie jako ikona Win32.Właściwość jest odpowiednikiem /win32icon przełącznik. |
ApplicationManifest |
Określa ścieżkę pliku, który jest używany do generowania zewnętrznych informacji manifestu Kontrola konta użytkownika (UAC).Dotyczy tylko projektów programu Visual Studio, wskazania Windows Vista. W większości przypadków jest wyposażony w manifeście.Jednakże korzystając z bezpłatnych COM rejestracji lub ClickOnce wdrożenia, a następnie manifest może być zewnętrzny plik zainstalowanego razem zestawy swojej 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óry jest przekazywana do ResolveKeySource — Zadanie do generowania rzeczywistego klucza, który jest używany do podpisywania zestawu. |
AssemblySearchPaths |
Lista lokalizacji wyszukiwania podczas rozpoznawania zestawu odwołania czas kompilacji.Kolejność wyświetlania ścieżek na tej liście jest zrozumiałe, ponieważ ścieżki wymienione wcześniej pierwszeństwo później wpisów. |
AssemblyName |
Nazwa zestawu danych wyjściowych po oparto projektu. |
BaseAddress |
Określa adres podstawowy zestawu głównego produktu.Ta właściwość jest odpowiednikiem /baseaddress przełącznik. |
BaseOutputPath |
Podstawowa ścieżka do pliku wyjściowego.Jeśli nie zostanie ustawiona, MSBuild użyje OutputPath = $(BaseOutputPath)\$(Configuration)\.Przykładowa składnia:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BaseIntermediateOutputPath |
Folder najwyższego poziomu, w których są tworzone wszystkie foldery wynikowe pośrednie specyficzne dla konfiguracji.Wartość domyślna to obj\.Następujący kod jest przykładem:<BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
BuildInParallel |
Wartość logiczną wskazującą, czy odwołaniami do projektów są wbudowane lub czyszczenia w równoległe podczas obsługi wielu procesorów MSBuild jest używany.Wartość domyślna to true, co oznacza, że projektów zostanie utworzona w równoległe w przypadku systemu z wieloma rdzeni lub procesory. |
BuildProjectReferences |
Wartość logiczną wskazującą, czy odwołaniami do projektów są tworzone przez MSBuild.Ustaw false w przypadku budowania projektu Visual Studio zintegrowane środowisko programistyczne (IDE), true Jeśli inaczej. |
CleanFile |
Nazwa pliku, który zostanie użyty jako "czyste pamięci podręcznej." Czyste pamięci podręcznej znajduje się lista plików generowanych ma zostać usunięty podczas operacji czyszczenia.Plik jest przekazywany w ścieżce pośrednie danych wyjściowych przez proces kompilacji. Ta właściwość określa tylko nazwy plików, które nie mają informacje o ścieżce. |
Strona kodowa |
Określa strony do użycia w przypadku wszystkich plików kodu źródłowego w kompilacji kodu.Ta właściwość jest odpowiednikiem /codepage przełącznik. |
CompilerResponseFile |
Plik opcjonalny odpowiedzi mogą być przekazywane do zadań kompilatora. |
Konfiguracja |
Konfiguracji, które tworzysz, "Debugowanie" lub "Wersji". |
CscToolPath |
Ścieżka csc.exe, Visual C# kompilatora. |
CustomBeforeMicrosoftCommonTargets |
Nazwa pliku projektu lub celów plik, który ma być importowany automatycznie przed wspólne zaimportowaniem celów. |
DebugSymbols |
Wartość logiczną wskazującą, czy symbole są generowane przez kompilacji. Ustawienie /p:DebugSymbols=false w wierszu polecenia wyłącza Generowanie plików symbol bazy danych (.pdb) programu. |
DefineConstants |
Definiuje stałe warunkowych kompilatora.Pary symbol i wartości są oddzielone średnikami i są określane za pomocą następującej składni: symbol1 = wartość1; Symbol2 = wartość2 Właściwość jest odpowiednikiem /define przełącznik. |
DefineDebug |
Wartość logiczna wskazuje, czy stała debugowania zdefiniowane. |
DefineTrace |
Wartość logiczna wskazuje, czy stała śledzenia zdefiniowane. |
DebugType |
Określa poziom informacji debugowania, który ma zostać wygenerowany.Prawidłowe wartości to "Pełna", "" pdbonly "" i "Brak." |
DelaySign |
Wartość logiczną wskazującą, czy ma podpisuje opóźnieniem zestawu, a nie pełny logowania. |
DisabledWarnings |
Pomija określonego ostrzeżenia.Należy określić liczbową część Identyfikator ostrzeżenia.Wiele ostrzeżeń są rozdzielone średnikami.Ten parametr jest odpowiednikiem /nowarn switch kompilatora vbc.exe. |
DisableFastUpToDateCheck |
Wartość logiczna, który ma zastosowanie do Visual Studio tylko.Visual Studio Tworzenie Menedżer używa procesu o nazwie FastUpToDateCheck w celu określenia, czy projekt musi zbudowane ponownie należy na bieżąco.Ten proces jest szybsze niż za pomocą MSBuild do określenia.Ustawienie właściwości DisableFastUpToDateCheck true umożliwia obejście Visual Studio tworzenie manager i wymusić użycie MSBuild do określenia, czy projekt jest na bieżąco. |
DocumentationFile |
Nazwa pliku, który zostanie wygenerowany jako plik dokumentacji XML.Ta nazwa zawiera nazwę pliku i nie ma ścieżki informacji. |
ErrorReport |
Określa, jak zadanie kompilator Zgłoś wewnętrzne błędy kompilatora.Prawidłowe wartości to "monit", "Prześlij" lub "Brak." Ta właściwość jest odpowiednikiem /errorreport przełącznik. |
ExcludeDeploymentUrl |
GenerateDeploymentManifest — Zadanie Dodaje znacznik deploymentProvider do manifestu wdrażania, jeśli plik projektu zawiera następujące elementy:
Przy użyciu ExcludeDeploymentUrl, jednak można zablokować tagu deploymentProvider przy dodawaniu do manifestu wdrażania, nawet jeśli którykolwiek z powyższych adresy URL są określone. Aby to zrobić, należy dodać do pliku projektu następujących właściwości: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>
|
FileAlignment |
Określa w bajtach, gdzie można dostosować w sekcjach plik wyjściowy.Prawidłowe wartości to: 512, 1024, 2048, 4096, 8192.Ta właściwość jest odpowiednikiem /filealignment przełącznik. |
FrameworkPathOverride |
Określa lokalizację mscorlib.dll i pliku microsoft.visualbasic.dll.Ten parametr jest odpowiednikiem /sdkpath switch kompilatora vbc.exe. |
GenerateDocumentation |
Parametr logiczną wskazującą, czy dokumentacja jest generowany przez kompilacji.Jeśli true, kompilacji generuje informacje o dokumentacji i umieszcza go w pliku XML wraz z nazwą pliku wykonywalnego lub biblioteki, który utworzył zadanie kompilacji. |
IntermediateOutputPath |
Ścieżka danych wyjściowych pełną pośrednie wynikające z BaseIntermediateOutputPath, jeśli nie określono ścieżki.Na przykład \obj\debug\.Jeśli ta właściwość zostanie zastąpiona, następnie ustawienie BaseIntermediateOutputPath nie działa. |
NazwaKonteneraKlucza |
Nazwa kontenera kluczy silnej nazwie. |
KeyOriginatorFile |
Nazwa pliku klucza silnej nazwie. |
NoWin32Manifest |
Określa, czy kompilator generuje manifest Win32 domyślnego do zestawu danych wyjściowych.Wartość domyślna false oznacza, że manifest Win32 domyślna jest generowany dla wszystkich aplikacji.Ta właściwość jest odpowiednikiem /nowin32manifest przełącznik klasy vbc.exe. |
ModuleAssemblyName |
Nazwa zestawu, który jest moduł skompilowany, należy włączyć do.Właściwość jest odpowiednikiem /moduleassemblyname przełącznik. |
NoLogo |
Wartość logiczna wskazuje, czy kompilator logo, które można wyłączyć.Ta właściwość jest odpowiednikiem /nologo przełącznik. |
NoStdLib |
Wartość logiczną wskazującą, czy w celu uniknięcia odwołujące się do biblioteki standardowej (mscorlib.dll).Wartość domyślna to false. |
NoVBRuntimeReference |
Wartość logiczną wskazującą, czy Visual Basic runtime (w pliku Microsoft.VisualBasic.dll) powinny być dołączone jako odwołanie w projekcie. |
NoWin32Manifest |
Wartość logiczną wskazującą, czy Kontrola konta użytkownika (UAC) manifestu informacje zostaną osadzone w aplikacji użytkownika pliku wykonywalnego.Dotyczy tylko projektów programu Visual Studio, wskazania Windows Vista.W projektach wdrażać za pomocą ClickOnce i wolne rejestracji COM, ten element jest ignorowane. False (wartość domyślna) określa, że kontrola konta użytkownika (UAC) manifestu informacje osadzone w pliku wykonywalnego aplikacji.TrueOkreśla, czy informacje o systemie UAC manifestu nie można osadzić. Ta właściwość ma zastosowanie tylko do Visual Studio projektów korzystających Windows Vista.W projektach wdrażać za pomocą ClickOnce i zwolnić rejestracji COM, ta właściwość jest ignorowane. NoWin32Manifest należy dodawać tylko wtedy, gdy użytkownik nie chce Visual Studio do osadzenia manifest wszelkie informacje w aplikacji użytkownika wykonywalnego; Ten proces jest nazywany virtualization.Aby użyć wirtualizacji, ustaw <ApplicationManifest> w połączeniu z <NoWin32Manifest> w następujący sposób:
|
Optymalizacja |
Wartość logiczną wartość, która jest ustawiona na wartość true, umożliwia optymalizacji kompilatora.Ta właściwość jest odpowiednikiem /optimize przełącznik. |
OptionCompare |
Określa, jak ciąg są porównań.Prawidłowe wartości to "binarna" lub "text". Ta właściwość jest odpowiednikiem /optioncompare przełącznik klasy vbc.exe. |
OptionExplicit |
Wartość logiczną wartość, która jest ustawiona na wartość true, wymaga jawnej deklaracji zmiennych w kodzie źródłowym.Ta właściwość jest odpowiednikiem /optionexplicit przełącznik. |
OptionInfer |
Wartość logiczną wartość, która jest ustawiona na wartość true, umożliwia wpisz wnioskowania zmiennych.Ta właściwość jest odpowiednikiem /optioninfer przełącznik. |
OptionStrict |
Wartość logiczną wartość, która jest ustawiona na wartość true, powoduje wymuszanie typu ścisłą semantykę do ograniczania niejawne konwersje typów zadania kompilacji.Ta właściwość jest odpowiednikiem /optionstrict switch 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 plik wyjściowy.Ten parametr może mieć jedną z następujących wartości:
Ta właściwość jest odpowiednikiem /target switch kompilatora vbc.exe. |
OverwriteReadOnlyFiles |
Wartość logiczną wskazującą, czy użytkownik chce włączyć kompilacji zastąpić pliki tylko do odczytu lub realizacja komunikat o błędzie. |
PdbFile |
Nazwa pliku pliku .pdb są emitowania.Ta właściwość jest odpowiednikiem /pdb switch kompilatora csc.exe. |
Platforma |
System operacyjny, który tworzysz dla.Prawidłowe wartości to "Dowolnymi CPU", "x 86" i "x 64". |
RemoveIntegerChecks |
Sprawdza, czy wartość logiczną wskazującą, czy wyłączyć błędów przepełnienia liczbę całkowitą.Wartość domyślna to false.Ta właściwość jest odpowiednikiem /removeintchecks switch kompilatora vbc.exe. |
SGenUseProxyTypes |
Wartość logiczną wskazującą, czy typy serwer proxy musi zostać wygenerowany przez SGen.exe. Cel SGen korzysta z tej właściwości, należy ustawić flagę UseProxyTypes.Ta właściwość jest wartość domyślna PRAWDA i nie ma żadnych interfejsu użytkownika, aby zmienić to ustawienie.Aby wygenerować zestawu serializacji dla typów — Usługa sieci Web, 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 wskazuje, gdzie można uzyskać SGen.exe, gdy zostanie zastąpiona bieżącej wersji programu SGen.exe. |
StartupObject |
Określa klasę lub moduł, który zawiera główne metody lub procedury Sub głównego.Ta właściwość jest odpowiednikiem /main przełącznik. |
Elementu ProcessorArchitecture |
Architektury procesora, która jest używana, gdy nie są rozwiązane odwołania do zestawów.Prawidłowe wartości to "msil", "x 86", "amd64" lub "ia64." |
RootNamespace |
Główna przestrzeń nazw do użycia w nazwach zasobów osadzonych.Ta przestrzeń nazw stanowi część nazwy manifestu zasobów osadzonych. |
Satellite_AlgorithmId |
Identyfikator algorytm mieszania AL.exe do użycia podczas tworzenia zestawy. |
Satellite_BaseAddress |
Adres podstawowy do użycia podczas zestawy określonej kultury są tworzone przy użyciu CreateSatelliteAssemblies docelowego. |
Satellite_CompanyName |
Nazwa firmy do przekazania do AL.exe podczas generowania zestawu urządzeń. |
Satellite_Configuration |
Nazwa konfiguracji do przekazania do AL.exe podczas generowania zestawu urządzeń. |
Satellite_Description |
Tekst opisu do przekazania do AL.exe podczas generowania zestawu urządzeń. |
Satellite_EvidenceFile |
Osadza określony plik w zestawie urządzeń z nazwą zasobu "Security.Evidence." |
Satellite_FileVersion |
Określa ciąg dla pola wersja pliku w zestawie urządzeń. |
Satellite_Flags |
Określa wartość pola flagi w zestawie urządzeń. |
Satellite_GenerateFullPaths |
Powoduje zadania kompilacji do użycia ścieżki bezwzględne pliki zgłoszone w komunikat o błędzie. |
Satellite_LinkResource |
Łączy pliki określony zasób do zestawu urządzeń. |
Satellite_MainEntryPoint |
Określa w pełni kwalifikowaną nazwę (czyli class.method) metodę używaną jako punkt wejścia, gdy moduł jest konwertowany na plik wykonywalny podczas generowania zestawu urządzeń. |
Satellite_ProductName |
Określa ciąg dla pola produktów w zestawie urządzeń. |
Satellite_ProductVersion |
Określa ciąg dla pola ProductVersion w zestawie urządzeń. |
Satellite_TargetType |
Określa format pliku plik wyjściowy zestawu urządzeń jako "Biblioteka", "exe," lub "wygrać". Wartość domyślna to "Biblioteka". |
Satellite_Title |
Określa ciąg dla pola tytułu w zestawie urządzeń. |
Satellite_Trademark |
Określa ciąg znaków towarowych pola w zestawie urządzeń. |
Satellite_Version |
Określa informacje o wersji dla zestawu urządzeń. |
Satellite_Win32Icon |
Wstawia plik ikony .ico w zestawie urządzeń. |
Satellite_Win32Resource |
Wstawia zasobu Win32 (.res pliku) do zestawu urządzeń. |
SubsystemVersion |
Minimalna wersja podsystemu, która może być używana w wygenerowanym pliku wykonywalnego.Ta właściwość jest odpowiednikiem /subsystemversion przełącznik.Aby uzyskać informacje o wartość domyślna tej właściwości, zobacz /subsystemversion (Visual Basic) lub /subsystemversion (opcje kompilatora C#). |
TargetCompactFramework |
Wersja programu .NET Framework Compact, które są wymagane do uruchomienia aplikacji, które tworzysz.Określenie tej umożliwia odwołuje się do niektórych struktury zestawów, które mogą nie być możliwość odwołania, w przeciwnym razie. |
TargetFrameworkVersion |
Wersja .NET Framework wymagane do uruchomienia aplikacji, które tworzysz.Określenie tej umożliwia odwołuje się do niektórych struktury zestawów, które mogą nie być możliwość odwołania, w przeciwnym razie. |
TreatWarningsAsErrors |
Parametr typu boolean, jeśli true, powoduje, że wszystkie ostrzeżenia powinien być traktowany jako błędy.Ten parametr jest odpowiednikiem /nowarn przełącznik. |
UseHostCompilerIfAvailable |
Parametr typu boolean, jeśli true, powoduje, że zadanie kompilacji do użycia w trakcie kompilator obiektu, jeśli jest dostępny.Ten parametr jest używany tylko w programie Visual Studio. |
Utf8Output |
Parametr typu boolean, jeśli true, rejestruje dane wyjściowe kompilatora przy użyciu kodowania UTF-8.Ten parametr jest odpowiednikiem /utf8Output przełącznik. |
VbcToolPath |
Opcjonalne ścieżkę wskazującą inną lokalizację vbc.exe w przypadku przesłonięcia jest bieżącej wersji programu vbc.exe. |
VbcVerbosity |
Określa szczegółowości Visual Basic kompilatora dla danych wyjściowych.Prawidłowe wartości to "Okna", "Normal" (wartość domyślna) lub "Pełne". |
VisualStudioVersion |
Określa wersję programu Visual Studio, którego ten projekt za ostateczną należy traktować jest uruchomiony.Jeśli ta właściwość nie jest określony, MSBuild ustawia na wartość domyślną stosowne. Ta właściwość jest używana w kilku typów projektu, aby określić zestaw obiektów docelowych, które są używane do kompilacji.Jeśli ToolsVersion jest ustawiony na 4.0 lub nowszym dla projektów, VisualStudioVersion służy do określania, które sub narzędzi do użycia.Aby uzyskać więcej informacji, zobacz Zestaw narzędzi MSBuild (ToolsVersion). |
WarningsAsErrors |
Określa listę ostrzeżeń do traktowania jako błędy.Ten parametr jest odpowiednikiem /warnaserror przełącznik. |
WarningsNotAsErrors |
Określa listę ostrzeżeń, które nie są traktowane jako błędy.Ten parametr jest odpowiednikiem /warnaserror przełącznik. |
Win32Manifest |
Nazwa pliku manifestu, które powinny być osadzone w montażu końcowego.Ten parametr jest odpowiednikiem /win32Manifest przełącznik. |
Win32Resource |
Nazwa pliku zasobu Win32 osadzone w montażu końcowego.Ten parametr jest odpowiednikiem /win32resource przełącznik. |