Udostępnij za pośrednictwem

Właściwości MSBuild zarezerwowane i dobrze znane

  • Artykuł

MSBuildudostępnia zestaw wstępnie zdefiniowanych właściwości, które zawierają informacje o pliku projektu programu i MSBuild plików binarnych.Te właściwości są oceniane w taki sam sposób, jak inne MSBuild właściwości.Na przykład, aby użyć MSBuildProjectFile właściwości, wpisz $(MSBuildProjectFile).

MSBuild używa wartości w poniższej tabeli do wstępnie zarezerwowane i dobrze znanych właściwości.Zarezerwowane właściwości nie można zastąpić, ale dobrze znanych właściwości można przesłonić przy użyciu właściwości środowiska nazwach, właściwości globalne lub właściwości, które zostały zgłoszone w pliku projektu.

Właściwości zarezerwowane i dobrze znane

W poniższej tabeli opisano MSBuild wstępnie zdefiniowane właściwości.

Właściwość

Opis

Zarezerwowanych lub dobrze znanych

MSBuildBinPath

Ścieżka bezwzględna folderu, gdzie MSBuild pliki binarne, które są aktualnie w użyciu znajdują się (na przykład C:\Windows\Microsoft.Net\Framework\numer_wersji).Ta właściwość jest przydatna, jeśli zachodzi potrzeba odwołują się do plików w MSBuild katalogu.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Zastrzeżone

MSBuildExtensionsPath

Wprowadzone w .NET Framework 4: nie ma różnicy pomiędzy wartościami domyślnymi MSBuildExtensionsPath i MSBuildExtensionsPath32.Można ustawić zmienną środowiskową MSBUILDLEGACYEXTENSIONSPATH na wartość inną niż null, aby ustawić wartości domyślne zachowanie MSBuildExtensionsPath we wcześniejszych wersjach.

W programie .NET Framework 3.5 i wcześniejszych, wartość domyślną MSBuildExtensionsPath wskazuje ścieżkę podfolderu MSBuild \Program Files\ lub \Program Files (x 86) w folderze, w zależności od liczbie bitów bieżącego procesu.Na przykład dla proces 32-bitowy na komputerze z 64-bitowych, ta właściwość wskazuje folderze \Program Files (x 86).Dla procesu 64-bitowych na komputerze z 64-bitowych ta właściwość wskazuje folder plików \Program.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Ta lokalizacja jest przydatna miejsce do umieszczenia plików niestandardowych docelowego.Na przykład pliki docelowego może zainstalowana na \Program Files\MSBuild\MyFiles\Northwind.targets i ponownym zaimportowaniu pliki projektu za pomocą tego kodu XML:

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

Dobrze znane

MSBuildExtensionsPath32

Ścieżka MSBuild podfolderu w \Program pliki lub \Program Files (x 86) folder.Ta zawsze ścieżkę do folderu \Program 32-bitowe pliki na komputerze 32-bitowy i \Program Files (x 86) na komputerze z 64-bitowej.Zobacz też MSBuildExtensionsPath i MSBuildExtensionsPath64.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Dobrze znane

MSBuildExtensionsPath64

Ścieżka MSBuild podfolder w folderze \Program plików.Dla komputera 64-bitowej to zawsze ścieżkę do folderu \Program plików.Maszyny 32-bitowy ta ścieżka jest pusta.Zobacz też MSBuildExtensionsPath i MSBuildExtensionsPath32.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Dobrze znane

MSBuildLastTaskResult

trueJeśli poprzednie zadanie zostało ukończone bez błędy (nawet jeśli wystąpiły ostrzeżenia), lub false Jeśli poprzednie zadanie z błędami.Zazwyczaj po wystąpieniu błędu w zadaniu, błędu jest ostatnim, opcjonalnym miało miejsce w tym projekcie.W związku z tym, wartość tej właściwości jest nigdy nie false, z wyjątkiem tych scenariuszach:

Zastrzeżone

MSBuildNodeCount

Maksymalna liczba jednoczesnych procesów, które są używane podczas tworzenia.Jest to wartość, który został przypisany do /maxcpucount w wierszu polecenia.Jeśli określono /maxcpucount bez określania wartości, następnie MSBuildNodeCount określa liczbę procesorów w komputerze.Aby uzyskać więcej informacji, zobacz Informacje w wierszu polecenia programu MSBuild i Równoległe tworzenie wielu projektów za pomocą narzędzia MSBuild.

Zastrzeżone

MSBuildProgramFiles32

Lokalizacja folderu program 32-bitowy; na przykład C:\Program Files (x86).

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Zastrzeżone

MSBuildProjectDefaultTargets

Pełna lista elementów docelowych, które są określone w DefaultTargets atrybutu Project elementu.Na przykład Poniższa Project element może zawierać MSBuildDefaultTargets wartości właściwości A;B;C:

<Project DefaultTargets="A;B;C" >

Zastrzeżone

MSBuildProjectDirectory

Bezwzględną ścieżkę katalogu, w którym plik projektu znajduje się, na przykład C:\MyCompany\MyProduct.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Zastrzeżone

MSBuildProjectDirectoryNoRoot

Wartość MSBuildProjectDirectory właściwości, z wyłączeniem główny dysk.

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Zastrzeżone

MSBuildProjectExtension

Rozszerzenie nazwy pliku z pliku projektu, w tym okresie; na przykład .proj.

Zastrzeżone

MSBuildProjectFile

Pełnej nazwy pliku z pliku projektu, w tym rozszerzenia nazwy pliku. na przykład MyApp.proj.

Zastrzeżone

MSBuildProjectFullPath

Ścieżka bezwzględna i pełną nazwę pliku projektu, rozszerzenia nazwy pliku, w tym na przykład C:\MyCompany\MyProduct\MyApp.proj.

Zastrzeżone

MSBuildProjectName

Nazwa pliku bez rozszerzenia nazwy pliku, plik projektu na przykład moja_aplikacja.

Zastrzeżone

MSBuildStartupDirectory

Ścieżka bezwzględna folderu, gdzie MSBuild jest wywoływana.Za pomocą tej właściwości, można tworzyć wszystko poniżej określonego punktu w drzewie projektu bez tworzenia dirs.proj plików w każdym katalogu.Zamiast tego ma tylko jeden projekt — na przykład c:\traversal.proj, jak pokazano poniżej:

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

Aby utworzyć w dowolnym momencie w drzewie, wpisz:

msbuild c:\traversal.proj

Nie zawierać końcowego ukośnika odwrotnego dla tej właściwości.

Zastrzeżone

MSBuildThisFile

Nazwa pliku i części rozszerzenia pliku MSBuildThisFileFullPath.

Zastrzeżone

MSBuildThisFileDirectory

Część katalogu MSBuildThisFileFullPath.

Ścieżka zawierać końcowego ukośnika odwrotnego.

Zastrzeżone

MSBuildThisFileDirectoryNoRoot

Część katalogu MSBuildThisFileFullPath, z wyłączeniem główny dysk.

Ścieżka zawierać końcowego ukośnika odwrotnego.

Zastrzeżone

MSBuildThisFileExtension

Nazwa rozszerzenia część plików MSBuildThisFileFullPath.

Zastrzeżone

MSBuildThisFileFullPath

Ścieżka bezwzględna pliku projektu lub obiekty docelowe, która zawiera obiekt docelowy, na którym działa.

PoradaPorada

W pliku obiektów docelowych, który jest względem pliku obiektów docelowych, a nie względem oryginalnego pliku projektu można określić ścieżkę względną.

Zastrzeżone

MSBuildThisFileName

Nazwa pliku część MSBuildThisFileFullPath, bez rozszerzenia nazwy pliku.

Zastrzeżone

MSBuildToolsPath

Ścieżka instalacji MSBuild wersji, który jest powiązany z wartością MSBuildToolsVersion.

Ścieżka nie powinien zawierać końcowego ukośnika odwrotnego.

Ta właściwość nie może zostać zastąpione.

Zastrzeżone

MSBuildToolsVersion

Wersja MSBuild zestaw narzędzi, który jest używany do tworzenia projektu.

[!UWAGA]

MSBuild Zestawu narzędzi składa się z zadań, celów i narzędzia, które służą do tworzenia aplikacji.Tych narzędzi należą: kompilatorów, takich jak csc.exe i vbc.exe.Aby uzyskać więcej informacji, zobacz Zestaw narzędzi MSBuild (ToolsVersion) i Konfiguracje standardowego i niestandardowego zestawu narzędzi.

Zastrzeżone

Zobacz też

Koncepcje

Właściwości programu MSBuild

Inne zasoby

Odwołanie do narzędzia MSBuild