Project, element (MSBuild)

  • Artykuł

Wymagany element główny pliku projektu MSBuild.

Składnia

<Project InitialTargets="TargetA;TargetB"
         DefaultTargets="TargetC;TargetD"
         TreatAsLocalProperty="PropertyA;PropertyB"
         ToolsVersion="<version number>"
         Sdk="name[/version]"
         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Sdk... />
    <Choose>... </Choose>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <Target>... </Target>
    <UsingTask.../>
    <ProjectExtensions>... </ProjectExtensions>
    <Import... />
</Project>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut opis
DefaultTargets Atrybut opcjonalny.

Domyślny element docelowy lub docelowy, który ma być punktem wejścia kompilacji, jeśli nie określono żadnego obiektu docelowego. Wiele obiektów docelowych to średnik (;) rozdzielany.

Jeśli w atrybucie lub wierszu polecenia MSBuild nie określono domyślnego DefaultTargets elementu docelowego, aparat wykonuje pierwszy element docelowy w pliku projektu po ocenie elementów importu .
InitialTargets Atrybut opcjonalny.

Początkowy element docelowy lub docelowy, który ma być uruchamiany przed obiektami docelowymi określonymi w atrybucie DefaultTargets lub w wierszu polecenia. Wiele obiektów docelowych jest rozdzielonych średnikami (;). Jeśli zdefiniuj InitialTargetswiele importowanych plików , zostaną uruchomione wszystkie wymienione obiekty docelowe, w kolejności, w której zostaną napotkane importy.
Sdk Atrybut opcjonalny.

Nazwa zestawu SDK i opcjonalna wersja do użycia w celu utworzenia niejawnych instrukcji Import, które są dodawane do pliku proj. Jeśli nie określono żadnej wersji, program MSBuild spróbuje rozpoznać wersję domyślną. Na przykład: <Project Sdk="Microsoft.NET.Sdk" /> lub <Project Sdk="My.Custom.Sdk/1.0.0" />.
ToolsVersion Atrybut opcjonalny.

Wersja zestawu narzędzi MSBuild używa do określania wartości $(MSBuildBinPath) i $(MSBuildToolsPath).
TreatAsLocalProperty Atrybut opcjonalny.

Nazwy właściwości, które nie będą uznawane za globalne. Ten atrybut uniemożliwia zastępowanie określonych właściwości wiersza polecenia wartości właściwości ustawionych w pliku projektu lub miejscami docelowymi i wszystkich kolejnych importów. Wiele właściwości to średnik (;) rozdzielany.

Zwykle właściwości globalne zastępują wartości właściwości, które są ustawiane w pliku projektu lub obiektów docelowych. Jeśli właściwość jest wymieniona w TreatAsLocalProperty wartości, wartość właściwości globalnej nie zastępuje wartości właściwości ustawionych w tym pliku i wszelkich kolejnych importów. Aby uzyskać więcej informacji, zobacz How to: Build the same source files with different options (Instrukcje: tworzenie tych samych plików źródłowych przy użyciu różnych opcji). Uwaga: właściwości globalne można ustawić w wierszu polecenia przy użyciu przełącznika -property (lub -p). Można również ustawić lub zmodyfikować właściwości globalne dla projektów podrzędnych w kompilacji wieloprojektowej przy użyciu Properties atrybutu zadania MSBuild. Aby uzyskać więcej informacji, zobacz ZADANIE MSBuild.
xmlns Atrybut opcjonalny.

Po określeniu xmlns atrybut musi mieć wartość http://schemas.microsoft.com/developer/msbuild/2003.

Elementy podrzędne

Element opis
Wybierz Element opcjonalny.

Ocenia elementy podrzędne, aby wybrać jeden zestaw ItemGroup elementów i/lub PropertyGroup elementów do obliczenia.
Importuj Element opcjonalny.

Umożliwia importowanie innego pliku projektu. W projekcie może istnieć zero lub więcej Import elementów.
ImportGroup Element opcjonalny.

Zawiera kolekcję Import elementów, które są pogrupowane w warunku opcjonalnym.
Itemgroup Element opcjonalny.

Element grupowania dla poszczególnych elementów. Elementy są określane przy użyciu elementu Item . W projekcie może istnieć zero lub więcej ItemGroup elementów.
Itemdefinitiongroup Element opcjonalny.

Umożliwia zdefiniowanie zestawu definicji elementów, które są wartościami metadanych, które są domyślnie stosowane do wszystkich elementów w projekcie. Element ItemDefinitionGroup zastępuje potrzebę użycia CreateItem zadania i CreateProperty zadania.
Rozszerzenia projektu Element opcjonalny.

Zapewnia sposób utrwalania informacji innych niż MSBuild w pliku projektu MSBuild. W projekcie może istnieć zero lub jeden ProjectExtensions element.
Propertygroup Element opcjonalny.

Element grupowania dla poszczególnych właściwości. Właściwości są określane przy użyciu elementu Property . W projekcie może istnieć zero lub więcej PropertyGroup elementów.
Sdk Element opcjonalny.

Odwołuje się do zestawu SDK projektu MSBuild. Tego elementu można użyć jako alternatywy dla atrybutu zestawu SDK.
Obiekt docelowy Element opcjonalny.

Zawiera zestaw zadań programu MSBuild do sekwencyjnego wykonywania. Zadania są określane przy użyciu elementu Task . W projekcie może istnieć zero lub więcej Target elementów.
Usingtask Element opcjonalny.

Zapewnia sposób rejestrowania zadań w programie MSBuild. W projekcie może istnieć zero lub więcej UsingTask elementów.

Elementy nadrzędne

Brak.

Zobacz też