Skip to content

Commit cae102a

Browse files
authored
Merge pull request #2501 from v-thepet/batch11
MSBuild #11
2 parents 9c89a70 + dc24b21 commit cae102a

10 files changed

+202
-233
lines changed

docs/msbuild/msbuild-items.md

Lines changed: 45 additions & 77 deletions
Large diffs are not rendered by default.

docs/msbuild/msbuild-multitargeting-overview.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ manager: douge
1111
ms.workload:
1212
- "multiple"
1313
---
14-
# MSBuild Multitargeting Overview
14+
# MSBuild multitargeting overview
1515
By using MSBuild, you can compile an application to run on any one of several versions of the .NET Framework, and on any one of several system platforms. For example, you can compile an application to run on the .NET Framework 2.0 on a 32-bit platform, and compile the same application to run on the .NET Framework 4.5 on a 64-bit platform.
1616

1717
> [!IMPORTANT]
@@ -29,17 +29,17 @@ By using MSBuild, you can compile an application to run on any one of several ve
2929

3030
- MSBuild targeting guarantees that an application uses only the functionality that is available in the targeted framework and platform.
3131

32-
## Target Framework and Platform
33-
A *target framework* is the version of the .NET Framework that a project is built to run on, and a *target platform* is the system platform that the project is built to run on. For example, you might want to target a .NET Framework 2.0 application to run on a 32-bit platform that is compatible with the 802x86 processor family (x86). The combination of target framework and target platform is known as the *target context*. For more information, see [Target Framework and Target Platform](../msbuild/msbuild-target-framework-and-target-platform.md).
32+
## Target framework and platform
33+
A *target framework* is the version of the .NET Framework that a project is built to run on, and a *target platform* is the system platform that the project is built to run on. For example, you might want to target a .NET Framework 2.0 application to run on a 32-bit platform that is compatible with the 802x86 processor family (x86). The combination of target framework and target platform is known as the *target context*. For more information, see [Target framework and target platform](../msbuild/msbuild-target-framework-and-target-platform.md).
3434

3535
## Toolset (ToolsVersion)
36-
A Toolset collects together the tools, tasks, and targets that are used to create the application. A Toolset includes compilers such as csc.exe and vbc.exe, the common targets file (microsoft.common.targets), and the common tasks file (microsoft.common.tasks). The 4.5 Toolset can be used to target .NET Framework versions 2.0, 3.0, 3.5, 4, and 4.5. However, the 2.0 Toolset can only be used to target the .NET Framework version 2.0. For more information, see [Toolset (ToolsVersion)](../msbuild/msbuild-toolset-toolsversion.md).
36+
A toolset collects together the tools, tasks, and targets that are used to create the application. A toolset includes compilers such as *csc.exe* and *vbc.exe*, the common targets file (*microsoft.common.targets*), and the common tasks file (*microsoft.common.tasks*). The 4.5 Toolset can be used to target .NET Framework versions 2.0, 3.0, 3.5, 4, and 4.5. However, the 2.0 Toolset can only be used to target the .NET Framework version 2.0. For more information, see [Toolset (ToolsVersion)](../msbuild/msbuild-toolset-toolsversion.md).
3737

38-
## Reference Assemblies
39-
The reference assemblies that are specified in the Toolset help you design and build an application. These reference assemblies not only enable a particular target build, but also restrict components and features in the Visual Studio IDE to those that are compatible with the target. For more information, see [Resolving Assemblies at Design Time](../msbuild/resolving-assemblies-at-design-time.md)
38+
## Reference assemblies
39+
The reference assemblies that are specified in the toolset help you design and build an application. These reference assemblies not only enable a particular target build, but also restrict components and features in the Visual Studio IDE to those that are compatible with the target. For more information, see [Resolving assemblies at design time](../msbuild/resolving-assemblies-at-design-time.md)
4040

41-
## Configuring Targets and Tasks
42-
You can configure MSBuild targets and tasks to run out-of-process with MSBuild so that you can target contexts that are considerably different than the one you are running on. For example, you can target a 32-bit, .NET Framework 2.0 application while the development computer is running on a 64-bit platform with .NET Framework 4.5. For more information, see [Configuring Targets and Tasks](../msbuild/configuring-targets-and-tasks.md).
41+
## Configure targets and tasks
42+
You can configure MSBuild targets and tasks to run out-of-process with MSBuild so that you can target contexts that are considerably different than the one you are running on. For example, you can target a 32-bit, .NET Framework 2.0 application while the development computer is running on a 64-bit platform with .NET Framework 4.5. For more information, see [Configuring targets and tasks](../msbuild/configuring-targets-and-tasks.md).
4343

4444
## Troubleshooting
45-
You might encounter errors if you try to reference an assembly that is not part of the target context. For more information about these errors and what to do about them, see [Troubleshooting .NET Framework Targeting Errors](../msbuild/troubleshooting-dotnet-framework-targeting-errors.md).
45+
You might encounter errors if you try to reference an assembly that is not part of the target context. For more information about these errors and what to do about them, see [Troubleshoot .NET Framework targeting errors](../msbuild/troubleshooting-dotnet-framework-targeting-errors.md).

docs/msbuild/msbuild-project-file-schema-reference.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -18,41 +18,41 @@ manager: douge
1818
ms.workload:
1919
- "multiple"
2020
---
21-
# MSBuild Project File Schema Reference
21+
# MSBuild project file schema reference
2222
Provides a table of all the [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] XML Schema elements with their available attributes and child elements.
2323

24-
[!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] uses project files to instruct the build engine what to build and how to build it. [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] project files are XML files that adhere to the [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] XML schema. This section documents the XML schema definition (.xsd) file for [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)].
24+
[!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] uses project files to instruct the build engine what to build and how to build it. [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] project files are XML files that adhere to the [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] XML schema. This section documents the XML schema definition (*.xsd*) file for [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)].
2525

26-
## MSBuild XML Schema Elements
26+
## MSBuild XML schema elements
2727
The following table lists all of the [!INCLUDE[vstecmsbuild](../extensibility/internals/includes/vstecmsbuild_md.md)] XML schema elements along with their child elements and attributes.
2828

29-
|Element|Child Elements|Attributes|
29+
|Element|Child elements|Attributes|
3030
|-------------|--------------------|----------------|
31-
|[Choose Element (MSBuild)](../msbuild/choose-element-msbuild.md)|Otherwise<br /><br /> When|--|
32-
|[Import Element (MSBuild)](../msbuild/import-element-msbuild.md)|--|Condition<br /><br /> Project|
33-
|[ImportGroup Element](../msbuild/importgroup-element.md)|Import|Condition|
34-
|[Item Element (MSBuild)](../msbuild/item-element-msbuild.md)|*ItemMetaData*|Condition<br /><br /> Exclude<br /><br /> Include<br /><br /> Remove|
35-
|[ItemDefinitionGroup Element (MSBuild)](../msbuild/itemdefinitiongroup-element-msbuild.md)|*Item*|Condition|
36-
|[ItemGroup Element (MSBuild)](../msbuild/itemgroup-element-msbuild.md)|*Item*|Condition|
37-
|[ItemMetadata Element (MSBuild)](../msbuild/itemmetadata-element-msbuild.md)|*Item*|Condition|
38-
|[OnError Element (MSBuild)](../msbuild/onerror-element-msbuild.md)|--|Condition<br /><br /> ExecuteTargets|
39-
|[Otherwise Element (MSBuild)](../msbuild/otherwise-element-msbuild.md)|Choose<br /><br /> ItemGroup<br /><br /> PropertyGroup|--|
40-
|[Output Element (MSBuild)](../msbuild/output-element-msbuild.md)|--|Condition<br /><br /> ItemName<br /><br /> PropertyName<br /><br /> TaskParameter|
41-
|[Parameter Element](../msbuild/parameter-element.md)|--|Output<br /><br /> ParameterType<br /><br /> Required|
42-
|[ParameterGroup Element](../msbuild/parametergroup-element.md)|*Parameter*|--|
43-
|[Project Element (MSBuild)](../msbuild/project-element-msbuild.md)|Choose<br /><br /> Import<br /><br /> ItemGroup<br /><br /> ProjectExtensions<br /><br /> PropertyGroup<br /><br /> Target<br /><br /> UsingTask|DefaultTargets<br /><br /> InitialTargets<br /><br /> ToolsVersion<br /><br /> TreatAsLocalProperty<br /><br /> xmlns|
44-
|[ProjectExtensions Element (MSBuild)](../msbuild/projectextensions-element-msbuild.md)|--|--|
45-
|[Property Element (MSBuild)](../msbuild/property-element-msbuild.md)|--|Condition|
46-
|[PropertyGroup Element (MSBuild)](../msbuild/propertygroup-element-msbuild.md)|*Property*|Condition|
47-
|[Sdk Element (MSBuild)](../msbuild/sdk-element-msbuild.md)|--|Name<br /><br /> Version|
48-
|[Target Element (MSBuild)](../msbuild/target-element-msbuild.md)|OnError<br /><br /> *Task*|AfterTargets<br /><br /> BeforeTargets<br /><br /> Condition<br /><br /> DependsOnTargets<br /><br /> Inputs<br /><br /> KeepDuplicateOutputs<br /><br /> Name<br /><br /> Outputs<br /><br /> Returns|
49-
|[Task Element (MSBuild)](../msbuild/task-element-msbuild.md)|Output|Condition<br /><br /> ContinueOnError<br /><br /> *Parameter*|
50-
|[TaskBody Element (MSBuild)](../msbuild/taskbody-element-msbuild.md)|*Data*|Evaluate|
51-
|[UsingTask Element (MSBuild)](../msbuild/usingtask-element-msbuild.md)|ParameterGroup<br /><br /> TaskBody|AssemblyFile<br /><br /> AssemblyName<br /><br /> Condition<br /><br /> TaskFactory<br /><br /> TaskName|
52-
|[When Element (MSBuild)](../msbuild/when-element-msbuild.md)|Choose<br /><br /> ItemGroup<br /><br /> PropertyGroup|Condition|
31+
|[Choose element (MSBuild)](../msbuild/choose-element-msbuild.md)|Otherwise<br /><br /> When|--|
32+
|[Import element (MSBuild)](../msbuild/import-element-msbuild.md)|--|Condition<br /><br /> Project|
33+
|[ImportGroup element](../msbuild/importgroup-element.md)|Import|Condition|
34+
|[Item element (MSBuild)](../msbuild/item-element-msbuild.md)|*ItemMetaData*|Condition<br /><br /> Exclude<br /><br /> Include<br /><br /> Remove|
35+
|[ItemDefinitionGroup element (MSBuild)](../msbuild/itemdefinitiongroup-element-msbuild.md)|*Item*|Condition|
36+
|[ItemGroup element (MSBuild)](../msbuild/itemgroup-element-msbuild.md)|*Item*|Condition|
37+
|[ItemMetadata element (MSBuild)](../msbuild/itemmetadata-element-msbuild.md)|*Item*|Condition|
38+
|[OnError element (MSBuild)](../msbuild/onerror-element-msbuild.md)|--|Condition<br /><br /> ExecuteTargets|
39+
|[Otherwise element (MSBuild)](../msbuild/otherwise-element-msbuild.md)|Choose<br /><br /> ItemGroup<br /><br /> PropertyGroup|--|
40+
|[Output element (MSBuild)](../msbuild/output-element-msbuild.md)|--|Condition<br /><br /> ItemName<br /><br /> PropertyName<br /><br /> TaskParameter|
41+
|[Parameter element](../msbuild/parameter-element.md)|--|Output<br /><br /> ParameterType<br /><br /> Required|
42+
|[ParameterGroup element](../msbuild/parametergroup-element.md)|*Parameter*|--|
43+
|[Project element (MSBuild)](../msbuild/project-element-msbuild.md)|Choose<br /><br /> Import<br /><br /> ItemGroup<br /><br /> ProjectExtensions<br /><br /> PropertyGroup<br /><br /> Target<br /><br /> UsingTask|DefaultTargets<br /><br /> InitialTargets<br /><br /> ToolsVersion<br /><br /> TreatAsLocalProperty<br /><br /> xmlns|
44+
|[ProjectExtensions element (MSBuild)](../msbuild/projectextensions-element-msbuild.md)|--|--|
45+
|[Property element (MSBuild)](../msbuild/property-element-msbuild.md)|--|Condition|
46+
|[PropertyGroup element (MSBuild)](../msbuild/propertygroup-element-msbuild.md)|*Property*|Condition|
47+
|[Sdk element (MSBuild)](../msbuild/sdk-element-msbuild.md)|--|Name<br /><br /> Version|
48+
|[Target element (MSBuild)](../msbuild/target-element-msbuild.md)|OnError<br /><br /> *Task*|AfterTargets<br /><br /> BeforeTargets<br /><br /> Condition<br /><br /> DependsOnTargets<br /><br /> Inputs<br /><br /> KeepDuplicateOutputs<br /><br /> Name<br /><br /> Outputs<br /><br /> Returns|
49+
|[Task element (MSBuild)](../msbuild/task-element-msbuild.md)|Output|Condition<br /><br /> ContinueOnError<br /><br /> *Parameter*|
50+
|[TaskBody element (MSBuild)](../msbuild/taskbody-element-msbuild.md)|*Data*|Evaluate|
51+
|[UsingTask element (MSBuild)](../msbuild/usingtask-element-msbuild.md)|ParameterGroup<br /><br /> TaskBody|AssemblyFile<br /><br /> AssemblyName<br /><br /> Condition<br /><br /> TaskFactory<br /><br /> TaskName|
52+
|[When element (MSBuild)](../msbuild/when-element-msbuild.md)|Choose<br /><br /> ItemGroup<br /><br /> PropertyGroup|Condition|
5353

54-
## See Also
55-
[Task Reference](../msbuild/msbuild-task-reference.md)
54+
## See also
55+
[Task reference](../msbuild/msbuild-task-reference.md)
5656
[Conditions](../msbuild/msbuild-conditions.md)
57-
[MSBuild Reference](../msbuild/msbuild-reference.md)
57+
[MSBuild reference](../msbuild/msbuild-reference.md)
5858
[MSBuild](../msbuild/msbuild.md)

0 commit comments

Comments
 (0)