Share via

AssignCulture 工作

  • 發行項

這項工作接受項目清單檔案名稱中包含有效的 .NET 文化特性識別碼字串，而產生的項目有包含對應的文化特性識別碼中繼資料，名為 Culture。 例如，檔案名稱 Form1.fr-fr.resx 有內嵌的文化特性識別碼 "fr-fr"，所以此工作會產生中繼資料 Culture 等於 fr-fr 的同檔名項目。 工作也會產生檔名移除了文化特性的檔案名稱清單。

工作參數

下表說明 AssignCulture 工作的參數。

參數 描述
AssignedFiles 選擇性的 ITaskItem[] 輸出參數。

包含以 Files 參數接收到的項目清單，每個項目都會新增 Culture 中繼資料項目。

如果從 Files 參數傳入的項目已包含 Culture 中繼資料項目，則使用原始的中繼資料項目。

如果檔案名稱中包含有效的文化特性識別碼，此工作只會指派 Culture 中繼資料項目。 文化特性識別碼必須介於檔案名稱的最後兩個點之間。
AssignedFilesWithCulture 選擇性的 ITaskItem[] 輸出參數。

包含來自 AssignedFiles 參數，具有 Culture 中繼資料項目的項目子集。
AssignedFilesWithNoCulture 選擇性的 ITaskItem[] 輸出參數。

包含來自 AssignedFiles 參數，沒有 Culture 中繼資料項目的項目子集。
CultureNeutralAssignedFiles 選擇性的 ITaskItem[] 輸出參數。

包含在 AssignedFiles 參數中產生的相同項目清單，除非檔案名稱移除文化特性。

如果是有效的文化特性識別碼，此工作只會移除檔案名稱中的文化特性。
Files 必要的 ITaskItem[] 參數。

指定檔案清單，內嵌要指派文化特性的文化特性名稱。 工作會嘗試找出每個檔案是否為特定文化特性的資源，如果是，則為文化特性。 若要略過此偵測程式，並強制將檔案設為非文化特性，請將中繼資料專案 WithCulture 設定為 false。

備註

除了本文所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

範例

下列範例會執行附 ResourceFiles 項目集合的 AssignCulture 工作。

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ResourceFiles Include="MyResource1.fr.resx"/>
        <ResourceFiles Include="MyResource2.XX.resx"/>
    </ItemGroup>

    <Target Name="Culture">
        <AssignCulture
            Files="@(ResourceFiles)"
            <Output TaskParameter="AssignedFiles"
                ItemName="OutAssignedFiles"/>
            <Output TaskParameter="AssignedFilesWithCulture"
                ItemName="OutAssignedFilesWithCulture"/>
            <Output TaskParameter="AssignedFilesWithNoCulture"
                ItemName="OutAssignedFilesWithNoCulture"/>
            <Output TaskParameter="CultureNeutralAssignedFiles"
                ItemName="OutCultureNeutralAssignedFiles"/>
        </AssignCulture>
    </Target>
</Project>

下表描述工作執行之後輸出項目的值。 專案元數據會顯示在項目之後的括弧中。

項目集合。 目錄
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (沒有額外的中繼資料)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (沒有額外的中繼資料)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (沒有額外的中繼資料)

另請參閱