GenerateResource 工作
在 .txt 和 .resx (XML 資源格式) 檔案與 Common Language Runtime 二進位 .resources 檔案 (可內嵌在執行階段二進位可執行檔，或是編譯到附屬組件中) 之間轉換。 此工作通常用於將 .txt 或 .resx 檔轉換為 .resources 檔。 GenerateResource 工作的功能類似於 resgen.exe。
參數
下表說明 GenerateResource 工作的參數。
| 參數 | 描述 |
|---|---|
AdditionalInputs |
選擇性的 ITaskItem[] 參數。包含此工作所執行相依性檢查的其他輸入。 例如，專案與目標檔案通常應為輸入，如有所更新時，就會重新產生所有資源。 |
EnvironmentVariables |
選擇性的 String[] 參數。指定環境變數的名稱/值組陣列，該名稱/值組除了 (或選擇性覆寫) 一般環境區塊之外，還應該傳遞至繁衍的 resgen.exe。 |
ExcludedInputPaths |
選擇性的 ITaskItem[] 參數。指定項目陣列，這會指定要在最新狀態檢查期間忽略所追蹤輸入的路徑。 |
ExecuteAsTool |
選擇性的 Boolean 參數。如果為 true，會從適當目標 Framework 跨處理序執行 tlbimp.exe 和 aximp.exe，以產生必要的包裝函式組件。 此參數允許多目標的 ResolveComReferences。 |
FilesWritten |
選擇性的 ITaskItem[] 輸出參數。包含寫入至磁碟的所有檔案名稱。 這包括快取檔案 (如果有的話)。 此參數對於 Clean 的實作很有用。 |
MinimalRebuildFromTracking |
選擇性的 Boolean 參數。取得或設定參數，指定是否將使用追蹤式累加建置。 如果為 true，會開啟累加建置，否則會強制重建。 |
NeverLockTypeAssemblies |
選擇性的 Boolean 參數。取得或設定布林值，該值可指定是否要建立新的 AppDomain 以評估資源 (.resx) 檔 (true)，或者只有在資源檔參考使用者的組件 (false) 時建立新的 AppDomain。 |
OutputResources |
選擇性的 ITaskItem[] 輸出參數。指定所產生檔案 (例如 .resources 檔案) 的名稱。 如果未指定名稱，會使用符合的輸入檔名稱，且建立的 .resources 檔案會置於包含該輸入檔的目錄中。 |
PublicClass |
選擇性的 Boolean 參數。如果為 true，會建立強型別資源類別做為公用類別。 |
References |
選擇性的 String[] 參數。要從中載入 .resx 檔案類型的參考。 .resx 檔案資料項目可能具有 .NET 類型。 讀取 .resx 檔案時，必須解析此類型。 一般而言，使用標準型別載入規則即可順利解析。 如果您提供 References 中的組件，則會優先使用它們。強型別資源不需要此參數。 |
SdkToolsPath |
選擇性的 String 參數。指定 SDK 工具 (例如 resgen.exe) 的路徑。 |
Sources |
必要的 ITaskItem[] 參數。指定要轉換的項目。 傳遞給此參數的項目必須具有下列其中一個副檔名︰ - .txt︰指定文字檔的副檔名以進行轉換。 文字檔只能包含字串資源。- .resx︰指定 XML 資源檔的副檔名以進行轉換。 - .restext︰指定和 .txt 相同的格式。 如果您想要清楚地區分包含資源的原始程式檔和建置流程中的其他原始程式檔，這個不同的副檔名會很有用。 - .resources︰指定資源檔的副檔名以進行轉換。 |
StateFile |
選擇性的 ITaskItem 參數。 指定選擇性快取檔案的路徑，這個檔案可用來加速 .resx 輸入檔中連結的相依性檢查。 |
StronglyTypedClassName |
選擇性的 String 參數。指定強型別資源類別的類別名稱。 如果未指定此參數，則會使用資源檔的基底名稱。 |
StronglyTypedFilename |
選擇性的 ITaskItem 參數。 指定原始程式檔的檔案名稱。 如果未指定此參數，則會使用類別名稱做為基底檔案名稱，副檔名則依語言而定。 例如：MyClass.cs。 |
StronglyTypedLanguage |
選擇性的 String 參數。指定當產生強型別資源的類別來源時所使用的語言。 此參數必須完全符合 CodeDomProvider 所使用的其中一種語言。 例如： VB 或 C#。藉由將值傳遞給此參數，您可以指示工作產生強型別資源。 |
StronglyTypedManifestPrefix |
選擇性的 String 參數。指定要在產生的強型別資源類別來源中使用的資源命名空間或資訊清單前置詞。 |
StronglyTypedNamespace |
選擇性的 String 參數。指定要為強型別資源產生的類別來源使用的命名空間。 如果未指定此參數，任何強型別資源都位在全域命名空間中。 |
TLogReadFiles |
選擇性 ITaskItem[] 唯讀參數。取得代表讀取追蹤記錄檔的項目陣列。 |
TLogWriteFiles |
選擇性 ITaskItem[] 唯讀參數。取得代表寫入追蹤記錄檔的項目陣列。 |
ToolArchitecture |
選擇性的 System.String 參數。 用來判斷是否需要使用 Tracker.exe 來繁衍 ResGen.exe。 應可剖析為 ExecutableType 列舉的成員。 如果為 String.Empty，請使用啟發學習法以判斷預設架構。 應可剖析為 Microsoft.Build.Utilities.ExecutableType 列舉的成員。 |
TrackerFrameworkPath |
選擇性的 String 參數。指定包含 FileTracker.dll 之適當 .NET Framework 位置的路徑。 如果設定，使用者要負責確定所傳遞的 FileTracker.dll 的位元和他們想要使用 ResGen.exe 的位元相符。 如果未設定，工作會根據目前的 .NET Framework 版本決定適當的位置。 |
TrackerLogDirectory |
選擇性的 String 參數。指定要用於放置執行此工作產生之追蹤記錄檔的中繼目錄。 |
TrackerSdkPath |
選擇性的 String 參數。指定包含 Tracker.exe 之適當 Windows SDK 位置的路徑。 如果設定，使用者要負責確定所傳遞之 Tracker.exe 的位元和他們想要使用之 ResGen.exe 的位元相符。 如果未設定，工作會根據目前的 Windows SDK 決定適當的位置。 |
TrackFileAccess |
選擇性的 Boolean 參數。 如果為 true，會使用輸入檔的目錄來解析相對檔案路徑。 |
UsePreserializedResources |
選擇性的 Boolean 參數。如果 true，則指定使用 PreserializedResourceWriter 而非 ResourceWriter 來序列化非字串資源，而 .NET Core 或 .NET 5 或更新版本不提供支援。 |
UseSourcePath |
選擇性的 Boolean 參數。如果為 true，會使用輸入檔的目錄來解析相對檔案路徑。 |
備註
因為 .resx 檔案可能包含連至其他資源檔的連結，所以只是比較 .resx 和 .resources 檔案時間戳記並不足以看出輸出是否為最新的。 相反地，GenerateResource 工作會追蹤 .resx 檔案中的連結，以及檢查所連結檔案的時間戳記。 這表示，您不應該只在包含 GenerateResource 工作的目標上使用 Inputs 與 Outputs 屬性，因為這可能會略過原本應該要執行的工作。
除了上述所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。
當使用 MSBuild 4.0 處理以 .NET 3.5 為目標的專案時，可能會因為 x86 資源而建置失敗。 若要解決這個問題，您可以將目標建置為 AnyCPU 組件。
UsePreserializedResources 參數會從一般 .NET 建置程序中的 $(GenerateResourceUsePreserializedResources) 屬性取得其值。 在 .NET Core 專案和使用 .NET 5 或更新版本的專案中，此屬性預設為 true。 您可以將 $(GenerateResourceUsePreserializedResources) 設定為 true，以允許 .NET SDK 建置以 .NET Framework 4.6.1 或更新版本為目標並使用非字串資源的專案。 System.Resources.Extensions 組件必須可在執行階段使用。 其適用於 .NET Core 3.0 和更新版本及 .NET 5 和更新版本，而且可透過 PackageReference 在 .NET Framework 4.6.1 或更新版本中使用。
範例
下列範例會使用 GenerateResource 工作從 Resx 項目集合指定的檔案來產生 .resources 檔案。
<GenerateResource
Sources="@(Resx)"
OutputResources="@(Resx->'$(IntermediateOutputPath)%(Identity).resources')">
<Output
TaskParameter="OutputResources"
ItemName="Resources"/>
</GenerateResource>
GenerateResource 工作使用 <EmbeddedResource> 項目的 <LogicalName> 中繼資料為組件中內嵌的資源命名。
假設組件名稱為 myAssembly，下列程式碼會產生名為 someQualifier.someResource.resources 的內嵌資源：
<ItemGroup>
<EmbeddedResource Include="myResource.resx">
<LogicalName>someQualifier.someResource.resources</LogicalName>
</EmbeddedResource>
</ItemGroup>
如果沒有 <LogicalName> 中繼資料，資源會命名為 myAssembly.myResource.resources。 此範例僅適用於 Visual Basic 和 Visual C# 建置流程。