共用方式為


MSBuild 轉換

轉換是指某個項目清單和另一個項目清單的一對一轉換作業。 轉換作業除了可讓專案轉換項目清單,還能讓目標識別其輸入和輸出之間的直接對應。 本主題說明轉換作業,以及 MSBuild 如何使用轉換作業以更有效建置專案。

轉換修飾詞

轉換並非任意性質,而是受到特殊語法的限制,該語法中所有轉換修飾詞都必須為 %(<ItemMetaDataName>) 格式。 任何項目中繼資料均可作為轉換修飾詞。 這包括每個項目建立時指派給項目的已知項目中繼資料。 如需已知項目中繼資料的清單,請參閱已知項目中繼資料

下列範例會將一份 .resx 檔案清單轉換為 .resources 檔案清單。 %(filename) 轉換修飾詞會指定每個 .resources 檔案使用與對應 .resx 檔案相同的檔案名稱。

@(RESXFile->'%(filename).resources')

比方說,如果 @(RESXFile) 項目清單中的項目是 Form1.resxForm2.resxForm3.resx,已轉換清單中的輸出會是 Form1.resourcesForm2.resourcesForm3.resources

注意

您可以為已轉換的項目清單指定自訂分隔符號 (方法與您為標準項目清單指定分隔符號的方式相同)。 例如,若要使用逗號 (,) 而不是預設的分號 (;) 來分隔已轉換的項目清單,請使用下列 XML: @(RESXFile->'Toolset\%(filename)%(extension)', ',')

使用多個修飾詞

轉換運算式可包含多個修飾詞,其可依照任何順序合併,亦可以重複。 在下列範例中,含有檔案的目錄名稱已變更,但這些檔案會保留原始名稱和副檔名。

@(RESXFile->'Toolset\%(filename)%(extension)')

比方說,如果 RESXFile 項目清單中包含的項目是 Project1\Form1.resxProject1\Form2.resxProject1\Form3.text,已轉換清單中的輸出會是 Toolset\Form1.resxToolset\Form2.resxToolset\Form3.text

相依性分析

轉換作業可保證轉換後的項目清單與原始項目清單之間的一對一對應。 因此,如果目標所建立的輸出是輸入的轉換項目,MSBuild 即會分析輸入和輸出的時間戳記,並決定是否略過、建置或部分重建目標。

在下列範例的 Copy 工作中,BuiltAssemblies 項目清單中的每個檔案都會對應至工作目的地資料夾中的檔案 (透過在 Outputs 屬性中使用轉換來指定)。 如果 BuiltAssemblies 項目清單中的檔案有所變更,系統就只會針對已變更的檔案執行 Copy 工作,並略過所有其他檔案。 如需相依性分析以及如何使用轉換的詳細資訊,請參閱如何:累加建置

<Target Name="CopyOutputs"
    Inputs="@(BuiltAssemblies)"
    Outputs="@(BuiltAssemblies -> '$(OutputPath)%(Filename)%(Extension)')">

    <Copy
        SourceFiles="@(BuiltAssemblies)"
        DestinationFolder="$(OutputPath)"/>

</Target>

範例

描述

下列範例示範使用轉換的 MSBuild 專案檔。 這個範例假設 c:\sub0\sub1\sub2\sub3 目錄中只有一個 .xsd 檔案,而工作目錄是 c:\sub0

程式碼

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Schema Include="sub1\**\*.xsd"/>
    </ItemGroup>

    <Target Name="Messages">
        <Message Text="rootdir: @(Schema->'%(rootdir)')"/>
        <Message Text="fullpath: @(Schema->'%(fullpath)')"/>
        <Message Text="rootdir + directory + filename + extension: @(Schema->'%(rootdir)%(directory)%(filename)%(extension)')"/>
        <Message Text="identity: @(Schema->'%(identity)')"/>
        <Message Text="filename: @(Schema->'%(filename)')"/>
        <Message Text="directory: @(Schema->'%(directory)')"/>
        <Message Text="relativedir: @(Schema->'%(relativedir)')"/>
        <Message Text="extension: @(Schema->'%(extension)')"/>
    </Target>
</Project>

註解

這個範例會產生下列輸出:

rootdir: C:\
fullpath: C:\sub0\sub1\sub2\sub3\myfile.xsd
rootdir + directory + filename + extension: C:\sub0\sub1\sub2\sub3\myfile.xsd
identity: sub1\sub2\sub3\myfile.xsd
filename: myfile
directory: sub0\sub1\sub2\sub3\
relativedir: sub1\sub2\sub3\
extension: .xsd