建立內嵌工作
MSBuild 工作通常是透過編譯實作 ITask 介面的類別來建立。 從 .NET Framework 4 版開始，您可以在專案檔中建立內嵌工作。 您不必建立個別的組件來裝載工作。 如需詳細資訊，請參閱內嵌工作。
本逐步解說示範如何建立並執行這些內嵌工作：
沒有輸入或輸出參數的工作。
有一個輸入參數，沒有輸出參數的工作。
有兩個輸入參數，一個傳回 MSBuild 屬性之輸出參數的工作。
有兩個輸入參數，一個傳回 MSBuild 項目之輸出參數的工作。
若要建立並執行作業，請使用 Visual Studio 和「Visual Studio 命令提示字元視窗」，如下所示︰
使用 Visual Studio 建立 MSBuild 專案檔。
修改 Visual Studio 中的專案檔以建立內嵌工作。
使用「命令提示字元視窗」來建置專案並檢查結果。
建立和修改 MSBuild 專案
Visual Studio 專案系統是以 MSBuild 為基礎。 因此，您可以使用 Visual Studio 建立組建專案檔。 在本節中，您將建立 Visual C# 專案檔。 (您可以改為建立 Visual Basic 專案檔。在本教學課程的內容中，這兩個專案檔之間的差異非常小)。
建立並修改專案檔
在 Visual Studio 中，使用 C# Windows Forms 應用程式範本建立新的專案。 在 [名稱] 方塊中，輸入
InlineTasks。 輸入方案的 [位置]，例如 D:\。 確認已選取 [為方案建立目錄]、已取消選取 [加入至原始檔控制]，且 [方案名稱] 為 InlineTasks。按一下 [確定] 以建立專案檔。
在 [方案總管] 中，以滑鼠右鍵按一下 [InlineTasks] 專案節點，然後按一下 [卸載專案]。
再次以滑鼠右鍵按一下專案節點，然後按一下 [編輯 InlineTasks.csproj]。
該專案檔隨即出現在程式碼編輯器中。
加入基本的 Hello 工作
現在，將顯示 "Hello, world!" 之訊息的基本工作加入到專案檔也加入預設 TestBuild 目標來叫用工作。
加入基本的 Hello 工作
在根
Project節點，將DefaultTargets屬性變更為TestBuild。產生的Project節點應該類似以下範例：<Project ToolsVersion="4.0" DefaultTargets="TestBuild" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">將下列的內嵌工作與目標加入到專案檔中的
</Project>標記之前。<UsingTask TaskName="Hello" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll" > <ParameterGroup /> <Task> <Code Type="Fragment" Language="cs"> Log.LogMessage(MessageImportance.High, "Hello, world!"); </Code> </Task> </UsingTask> <Target Name="TestBuild"> <Hello /> </Target>儲存專案檔。
此程式碼會建立名為 Hello 且沒有參數、參考或
Using指示詞的內嵌工作。 Hello 工作僅包含一行程式碼，它會在預設記錄裝置 (通常是在主控台視窗) 上顯示 hello 訊息。
執行 Hello 工作
使用「命令提示字元視窗」執行 MSBuild，以建構 Hello 工作並處理叫用它的 TestBuild 目標。
執行 Hello 工作
按一下 [開始]，按一下 [所有程式]，接著尋找 Visual Studio Tools 資料夾，然後按一下 [Visual Studio 命令提示字元]。
在 [命令提示字元視窗]，中找出包含專案檔的資料夾，此案例中為 D:\InlineTasks\InlineTasks\。
在不使用命令參數的情況下輸入 msbuild，然後按 Enter。 根據預設，這會建置 InlineTasks.csproj 檔案並處理會叫用 Hello 工作的預設目標 TestBuild。
檢查「命令提示字元視窗」中的輸出。 您應該會看到下列這一行：
Hello, world!注意
如果您沒有看到 hello 訊息，請嘗試重新儲存專案檔，然後執行 Hello 工作。
藉由交替使用程式碼編輯器和「命令提示字元視窗」，您可以變更專案檔並快速查看結果。
定義 Echo 工作
建立接受字串參數，並會在預設記錄裝置上顯示字串的內嵌工作。
定義 Echo 工作
在程式碼編輯器中，使用下列程式碼取代 Hello 工作和 TestBuild 目標。
<UsingTask TaskName="Echo" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll" > <ParameterGroup> <Text Required="true" /> </ParameterGroup> <Task> <Code Type="Fragment" Language="cs"> Log.LogMessage(MessageImportance.High, Text); </Code> </Task> </UsingTask> <Target Name="TestBuild"> <Echo Text="Greetings!" /> </Target>在 [命令提示字元視窗] 中，在不使用命令參數的情況下輸入 msbuild，然後按 Enter。 根據預設，這會處理叫用 Echo 工作的預設目標 TestBuild。
檢查「命令提示字元視窗」中的輸出。 您應該會看到下列這一行：
Greetings!此程式碼會定義名為 Echo，且僅有一個必要的輸入參數 Text 的內嵌工作。 根據預設，參數屬於類型 System.String。 當 TestBuild 目標叫用 Echo 工作時，會設定 Text 參數的值。
定義 Adder 工作
建立會將兩個整數參數加總，且將其總和以 MSBuild 屬性發出的內嵌工作。
定義 Adder 工作
在程式碼編輯器中，使用下列程式碼取代 Echo 工作和 TestBuild 目標。
<UsingTask TaskName="Adder" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll" > <ParameterGroup> <A ParameterType="System.Int32" Required="true" /> <B ParameterType="System.Int32" Required="true" /> <C ParameterType="System.Int32" Output="true" /> </ParameterGroup> <Task> <Code Type="Fragment" Language="cs"> C = A + B; </Code> </Task> </UsingTask> <Target Name="TestBuild"> <Adder A="4" B="5"> <Output PropertyName="Sum" TaskParameter="C" /> </Adder> <Message Text="The sum is $(Sum)" Importance="High" /> </Target>在 [命令提示字元視窗] 中，在不使用命令參數的情況下輸入 msbuild，然後按 Enter。 根據預設，這會處理叫用 Echo 工作的預設目標 TestBuild。
檢查「命令提示字元視窗」中的輸出。 您應該會看到下列這一行：
The sum is 9此程式碼會定義名為 Adder，且有兩個必要整數輸入參數 A 和 B，以及一個整數輸出參數 C 的內嵌工作。Adder 工作會將兩個輸入參數加總，並在輸出參數中傳回總和。 總和會以 MSBuild 屬性
Sum發出。 當 TestBuild 目標叫用 Adder 工作時，會設定輸入參數的值。
定義 RegX 工作
建立一個內嵌工作，該內嵌工作會接受項目群組和規則運算式，且傳回所有具備符合運算式之檔案內容的項目清單。
定義 RegX 工作
在程式碼編輯器中，使用下列程式碼取代 Adder 工作和 TestBuild 目標。
<UsingTask TaskName="RegX" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll" > <ParameterGroup> <Expression Required="true" /> <Files ParameterType="Microsoft.Build.Framework.ITaskItem[]" Required="true" /> <Result ParameterType="Microsoft.Build.Framework.ITaskItem[]" Output="true" /> </ParameterGroup> <Task> <Using Namespace="System.Text.RegularExpressions"/> <Code Type="Fragment" Language="cs"> <![CDATA[ if (Files.Length > 0) { Result = new TaskItem[Files.Length]; for (int i = 0; i < Files.Length; i++) { ITaskItem item = Files[i]; string path = item.GetMetadata("FullPath"); using(StreamReader rdr = File.OpenText(path)) { if (Regex.Match(rdr.ReadToEnd(), Expression).Success) { Result[i] = new TaskItem(item.ItemSpec); } } } } ]]> </Code> </Task> </UsingTask> <Target Name="TestBuild"> <RegX Expression="public|protected" Files="@(Compile)"> <Output ItemName="MatchedFiles" TaskParameter="Result" /> </RegX> <Message Text="Input files: @(Compile)" Importance="High" /> <Message Text="Matched files: @(MatchedFiles)" Importance="High" /> </Target>在 [命令提示字元視窗] 中，在不使用命令參數的情況下輸入 msbuild，然後按 Enter。 根據預設，這會處理會叫用 RegX 工作的預設目標 TestBuild。
檢查「命令提示字元視窗」中的輸出。 您應該會看到下列這幾行：
Input files: Form1.cs;Form1.Designer.cs;Program.cs;Properties\AssemblyInfo.cs;Properties\Resources.Designer.cs;Properties\Settings.Designer.csMatched files: Form1.cs;Form1.Designer.cs;Properties\Settings.Designer.cs此程式碼定義名為 RegX，且具備下列三個參數的內嵌工作：
Expression是必要的字串輸入參數，其值為要比對的規則運算式。 在此範例中，運算式符合字組「公用」或「受保護」。Files是必要的項目清單輸入參數，其值為要搜尋以比對之檔案的清單。 在此範例中，Files設定為Compile項目，其中會列出專案原始程式檔。Result是輸出參數，其值為具備符合規則運算式之內容的檔案清單。當 TestBuild 目標叫用 RegX 工作時，會設定輸入參數的值。 RegX 工作會讀取每個檔案，並傳回符合規則運算式之檔案的清單。 這份清單會以
Result輸出參數傳回，會以 MSBuild 項目MatchedFiles發出。
處理保留字元
MSBuild 剖析器會以 XML 的方式處理內嵌工作。 在 XML 中具備保留意義的字元 (例如 "<" 和 ">") 會以如同 XML (而非 .NET 原始碼) 的方式偵測與處理。 若要在程式碼運算式中包含保留字元 (例如 Files.Length > 0)，請撰寫 Code 元素，讓其內容包含在 CDATA 運算式中，如下所示︰
<Code Type="Fragment" Language="cs">
<![CDATA[
if (Files.Length > 0)
{
// Your code goes here.
}
]]>
</Code>