AssignCulture 工作
更新：2007 年 11 月
這項工作可接受一份項目清單，清單中可包含做為檔案名稱一部分的有效 .NET 文化特性 (Culture) 識別項，並產生具有 Culture 中繼資料 (Metadata，其中含有對應的文化特性識別項) 的項目。例如，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 |
選擇性 (Optional) ITaskItem[] 參數。 指定要指派文化特性的檔案清單，這些檔案具有內嵌的文化特性名稱。 |
範例
下列範例對 ResourceFiles 項目集合執行 AssignCulture 工作。
<Project xmlns="https://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 (沒有其他中繼資料) |