WriteCodeFragment タスク

アセンブリ レベルの属性を生成する

MSBuild 17.7 以降では、アセンブリ レベルの属性に対してさまざまなパラメーター型をサポートするように、このタスクが更新されました。 MSBuild 17.6 以前は、アセンブリ レベルの属性のパラメーター型として String のみがサポートされていました。 MSBuild 17.7 以降では、以前のバージョンの MSBuild のように、パラメーターが文字列型である属性だけでなく、任意の .NET アセンブリ属性を構築できます。

たとえば、ブール値パラメーターを使用するアセンブリ レベルの属性 CLSCompliant(true) を定義するには、次の構文を使用できます:

<ItemGroup>
    <AssemblyAttribute Include="System.CLSCompliantAttribute">
        <_Parameter1>true</_Parameter1>
    </AssemblyAttribute>
</ItemGroup>

生成されるコードは、ターゲット言語によって異なります。 C# の場合、次のようになります:

[assembly: System.CLSCompliantAttribute(true)]

mscorlib で定義された型は、前の例のブール値など、自動的に推論されます。 フォーム {parameter}_TypeName のメタデータを定義して、推論できない型を指定できます。

<ItemGroup>
    <AssemblyAttribute Include="Microsoft.Owin.OwinStartup">
        <_Parameter1>Microsoft.Examples.Startup</_Parameter1>
        <_Parameter1_TypeName>System.Type</_Parameter1_TypeName>
    </AssemblyAttribute>
</ItemGroup>

C# で生成されるコードは次のとおりです:

[assembly: Microsoft.Owin.OwinStartup(typeof(Microsoft.Examples.Startup))]

より複雑なパラメーター値の場合は、{parameter}_IsLiteral を使用できます。

<ItemGroup>
    <AssemblyAttribute Include="NUnit.Framework.Parallelizable">
        <_Parameter1>NUnit.Framework.ParallelScope.Fixtures</_Parameter1>
        <_Parameter1_IsLiteral>true</_Parameter1_IsLiteral>
    </AssemblyAttribute>
</ItemGroup>

前の例では、C# で次のアセンブリ属性が生成されます:

[assembly: NUnit.Framework.Parallelizable(NUnit.Framework.ParallelScope.Fixtures)]

通常、プロジェクトの言語で属性宣言で許可される任意の構文を使用できます。 配列パラメーターの場合は、次のようなコードを使用できます:

<ItemGroup>
  <AssemblyAttribute Include="TestAttribute">
    <_Parameter1>new int[] { 1, 3, 5 } /* odd numbers */</_Parameter1>
    <_Parameter1_IsLiteral>true</_Parameter1_IsLiteral>
  </AssemblyAttribute>
</ItemGroup>

IsLiteral を使用すると、構文は適切なコンパイラによって解釈されるため、言語固有です。 複数の言語が同じ MSBuild インポート ファイルやプロジェクト ファイルを共有している場合は、条件付き構文を使用して、コードが関連するプロジェクト固有の言語でコンパイルされるようにする必要があります。