インラインタスクの作成

[アーティクル]
06/19/2023

MSBuild タスクは通常、ITask インターフェイスを実装するクラスをコンパイルして作成します。 .NET Framework Version 4 以降では、プロジェクトファイルでタスクをインラインで作成できます。個別のアセンブリを作成してタスクをホストする必要はありません。詳細については、「インラインタスク」を参照してください。

このチュートリアルでは、次のインラインタスクを作成し、実行する方法について説明します。

入力パラメーターも出力パラメーターも持たないタスク。
1 つの入力パラメーターを持つが出力パラメーターを持たないタスク。
2 つの入力パラメーターと、MSBuild プロパティを返す 1 つの出力パラメーターを持つタスク。
2 つの入力パラメーターと、MSBuild 項目を返す 1 つの出力パラメーターを持つタスク。

タスクを作成して実行するには、Visual Studio と Visual Studio コマンドプロンプトウィンドウを使用して次の操作を実行します。

Visual Studio を使用して MSBuild プロジェクトファイルを作成します。
Visual Studio でプロジェクトファイルを変更してインラインタスクを作成します。
コマンドプロンプトウィンドウを使用してプロジェクトをビルドし、結果を確認します。

MSBuild プロジェクトの作成と変更を行う

Visual Studio プロジェクトシステムは MSBuild に基づいています。したがって、ビルドプロジェクトファイルは Visual Studio を使用して作成できます。このセクションでは、Visual C# プロジェクトファイルを作成します (代わりに、Visual Basic プロジェクトファイルを作成することもできます。このチュートリアルのコンテキストでは、2 つのプロジェクトファイルにはわずかな違いしかありません)。

プロジェクトファイルを作成および変更するには

Visual Studio で、C# Windows フォームアプリケーション テンプレートを使用して新しいプロジェクトを作成します。 [名前] ボックスに「InlineTasks」と入力します。ソリューションの場所を入力します (例: D:\)。 [ソリューションのディレクトリを作成] がオンになっていることと、[ソース管理に追加] がオフになっていること、さらに [ソリューション名] が InlineTasks になっていることを確認します。
[OK] をクリックして、プロジェクトファイルを作成します。
ソリューションエクスプローラーで、[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>

プロジェクトファイルを保存します。

このコードによって、パラメーター、参照、または Using ディレクティブがない Hello という名前のインラインタスクが作成されます。この Hello タスクには、既定のログデバイス (通常はコンソールウィンドウ) に Hello メッセージを表示する 1 行のコードのみが含まれています。

Hello タスクを実行する

コマンドプロンプトウィンドウを使用して MSBuild を実行し、Hello タスクを構築して、そのタスクを呼び出す TestBuild ターゲットを処理します。

Hello タスクを実行するには

[スタート]、[すべてのプログラム] の順にクリックし、[Visual Studio Tools] フォルダーを見つけて [Visual Studio コマンドプロンプト] をクリックします。
コマンドプロンプトウィンドウで、プロジェクトファイルが格納されているフォルダー (この場合は D:\InlineTasks\InlineTasks\) を見つけます。
コマンドスイッチを指定せずに「msbuild」と入力し、Enter キーを押します。既定では、これによって InlineTasks.csproj ファイルがビルドされ、Hello タスクを呼び出す既定のターゲット TestBuild が処理されます。
コマンドプロンプトウィンドウで出力を確認します。次の行が表示されます。

Hello, world!

Note

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!

このコードによって、必須の入力パラメーター Text を 1 つだけ持つ Echo という名前のインラインタスクが定義されます。既定では、パラメーターの型は System.String です。 Text パラメーターの値は、TestBuild ターゲットによって Echo タスクが呼び出されたときに設定されます。

Adder タスクを定義する

2 つの整数パラメーターを追加して、その合計を 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 という名前のインラインタスクが定義されます。このタスクには、2 つの必須の整数入力パラメーター A と B、および 1 つの整数出力パラメーター C があります。Adder タスクによって 2 つの入力パラメーターが追加され、出力パラメーターで合計が返されます。合計は 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.cs
```
```
Matched files: Form1.cs;Form1.Designer.cs;Properties\Settings.Designer.cs
```
このコードによって、次の 3 つのパラメーターを持つ RegX という名前のインラインタスクが定義されます。

Expression: 照合する正規表現を示す値を持つ必須の文字列入力パラメーター。この例では、正規表現は "public" または "protected" という語と一致します。
Files: 一致する語を検索するファイルの一覧を示す値を持つ必須の項目一覧入力パラメーター。この例では、Files はプロジェクトソースファイルを一覧表示する Compile 項目に設定されます。
Result: 正規表現と一致する内容を含むファイルの一覧を示す値を持つ出力パラメーター。

入力パラメーターの値は、TestBuild ターゲットによって RegX タスクが呼び出されたときに設定されます。 RegX タスクによってすべてのファイルが読み取られ、正規表現と一致するファイルの一覧が返されます。この一覧は Result 出力パラメーターとして返され、MSBuild 項目 MatchedFiles として生成されます。

予約文字を使用する

MSBuild パーサーによってインラインタスクが XML として処理されます。 XML で意味が予約されている文字 ("<" や ">" など) は、.NET ソースコードではなく XML として検出されて処理されます。コード式に予約文字を含めるには (Files.Length > 0 など)、次のように Code 要素を記述して、その内容が CDATA 式に含まれるようにします。

<Code Type="Fragment" Language="cs">
 <![CDATA[

 if (Files.Length > 0)
 {
     // Your code goes here.
 }
 ]]>
</Code>

Share via

インラインタスクの作成

MSBuild プロジェクトの作成と変更を行う

プロジェクトファイルを作成および変更するには

基本的な Hello タスクを追加する

基本的な Hello タスクを追加するには

Hello タスクを実行する

Hello タスクを実行するには

Echo タスクを定義する

Echo タスクを定義するには

Adder タスクを定義する

Adder タスクを定義するには

RegX タスクを定義する

RegX タスクを定義するには

予約文字を使用する

フィードバック

フィードバック

その他のリソース

Share via

インライン タスクの作成

MSBuild プロジェクトの作成と変更を行う

プロジェクト ファイルを作成および変更するには

基本的な Hello タスクを追加する

基本的な Hello タスクを追加するには

Hello タスクを実行する

Hello タスクを実行するには

Echo タスクを定義する

Echo タスクを定義するには

Adder タスクを定義する

Adder タスクを定義するには

RegX タスクを定義する

RegX タスクを定義するには

予約文字を使用する

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

インラインタスクの作成

プロジェクトファイルを作成および変更するには