Udostępnij za pośrednictwem

Program MSBuild zarezerwowanych właściwości

  • Artykuł

MSBuildzawiera zestaw właściwości zastrzeżonych, przechowujących informacje o pliku projektu i MSBuild pliki binarne.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ść, wpisz:

$(MSBuildProjectFile)

Właściwości zastrzeżonych

W poniższej tabeli opisano MSBuild zastrzeżone właściwości.

Właściwość

Opis

MSBuildBinPath

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

MSBuildExtensionsPath

Ścieżka do MSBuild podfolder w \Program Files\ lub \Program Files (x 86) \ folder, w zależności od bitowości bieżącego okna.Na przykład dla okna 32-bitowe w 64-bitowym, ścieżka wskazuje \Program Files (x 86) \ folderu.Dla okna 64-bitowe w 64-bitowym ścieżka wskazuje się w folderze \Program Files\.See also MSBuildExtensionsPath32 and MSBuildExtensionsPath64.

Ta lokalizacja jest użyteczne miejsce do umieszczania plików niestandardowe miejsce docelowe.Na przykład plików docelowych może zainstalowany w \Program Files\MSBuild\MyFiles\Northwind.targets i ponownym zaimportowaniu plików projektu za pomocą tego kodu XML:

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

UwagaUwaga
Wartość niezerową, aby umożliwić zachowanie można ustawić zmienną środowiskową MSBUILDLEGACYEXTENSIONSPATH MSBuildExtensionsPath w poprzednich wersjach.

MSBuildExtensionsPath32

Ścieżka do MSBuild podfolder w \Program Files\ lub \Program Files (x 86) \ folderu.Ta ścieżka wskazuje się zawsze do folderu \Program Files\ 32-bitowych na 32-bitowe maszyny i \Program pliki (x 86) \ na komputerze 64-bitowych.See also MSBuildExtensionsPath and MSBuildExtensionsPath64.

MSBuildExtensionsPath64

Ścieżka do MSBuild podfolder w folderze \Program Files\.Dla 64-bitowym ta ścieżka jest zawsze zwrócony w folderze \Program Files\.Dla 32-bitowe ta ścieżka jest pusta.See also MSBuildExtensionsPath and MSBuildExtensionsPath32.

MSBuildLastTaskResult

trueJeżeli poprzednie zadanie wykonane bez żadnych błędów (nawet jeśli wystąpiły ostrzeżenia) lub false Jeśli poprzednie zadanie wystąpiły błędy.

UwagaUwaga
Zazwyczaj gdy wystąpi błąd w zadaniu, błąd jest ostatnią rzeczą, co dzieje się w tym projekcie.W związku z tym, wartość tej właściwości nie jest nigdy nie false, z wyjątkiem tych scenariuszy:

MSBuildNodeCount

Maksymalna liczba równoczesnych procesów, które są używane do tworzenia.Jest to wartość, który został określony dla /maxcpucount w wierszu polecenia.Jeśli określono /maxcpucount bez określenia 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.

MSBuildProgramFiles32

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

MSBuildProjectDefaultTargets

Pełną listę obiektów docelowych, które są określone w DefaultTargets atrybut Projekt element.Na przykład, następująca Project element będzie mieć MSBuildDefaultTargets wartość właściwości A;B;C:

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

MSBuildProjectDirectory

Bezwzględna ścieżka katalogu, gdzie plik projektu znajduje; na przykład C:\MyCompany\MyProduct\.

MSBuildProjectDirectoryNoRoot

Wartość MSBuildProjectDirectory właściwość, z wyłączeniem dysku głównym.

MSBuildProjectExtension

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

MSBuildProjectFile

Pełną nazwę pliku projektu, w tym rozszerzenie nazwy pliku; na przykład MyApp.proj.

MSBuildProjectFullPath

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

MSBuildProjectName

Nazwa pliku w pliku projektu bez rozszerzenia nazwy pliku; na przykład MyApp.

MSBuildStartupDirectory

Bezwzględna ścieżka folderu, gdzie MSBuild nosi nazwę.Za pomocą tej właściwości, można zbudować wszystko poniżej określonego punktu w drzewie projektu bez tworzenia plików dirs.proj w każdym katalogu.Istnieją jednak 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, należy wpisać:

msbuild c:\traversal.proj

MSBuildThisFile

Nazwa pliku i rozszerzenie część plików MSBuildThisFileFullPath.

MSBuildThisFileDirectory

Część katalogu MSBuildThisFileFullPath.

MSBuildThisFileDirectoryNoRoot

Część katalogu MSBuildThisFileFullPath, z wyłączeniem dysku głównym.

MSBuildThisFileExtension

Plik rozszerzenia fragment nazwy MSBuildThisFileFullPath.

MSBuildThisFileFullPath

Bezwzględna ścieżka pliku projektu lub obiektów docelowych, który zawiera cel, którym jest uruchomiony.

PoradaPorada
MSBuildThisFileFullPath Właściwość umożliwia określenie ścieżki względnej w pliku obiektów docelowych, który jest względem pliku obiektów docelowych, a nie w stosunku do oryginalnego pliku projektu.

MSBuildThisFileName

Część nazwy pliku MSBuildThisFileFullPath, bez rozszerzenia nazwy pliku.

MSBuildToolsPath

Ścieżka instalacji MSBuild wersji, która jest skojarzona z wartość MSBuildToolsVersion.

MSBuildToolsVersion

Wersja MSBuild zestaw narzędzi, który służy do budowania projektu.

UwagaUwaga
MSBuild Zestaw narzędzi, który składa się z zadania, cele i narzędzia, które są używane do budowania aplikacji.Obejmują one kompilatory takie 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.

Zobacz też

Koncepcje

Program MSBuild właściwości

Inne zasoby

Program MSBuild odniesienia