GenerateDeploymentManifest 工作
產生 ClickOnce 部署資訊清單。 ClickOnce 部署資訊清單透過定義部署的唯一識別、識別例如安裝或線上模式的部署特性、指定應用程式更新設定和更新位置，以及指出對應的 ClickOnce 應用程式資訊清單，來描述應用程式部署。
參數
下表說明 GenerateDeploymentManifest 工作的參數。
| 參數 | 描述 |
|---|---|
AssemblyName |
選擇性的 String 參數。針對產生的資訊清單指定組件識別的 Name 欄位。 如果未指定此參數，會從 EntryPoint 或 InputManifest 參數來推斷名稱。 如果無法推斷名稱，工作就會擲回錯誤。 |
AssemblyVersion |
選擇性的 String 參數。針對產生的資訊清單指定組件識別的 Version 欄位。 如果未指定此參數，工作會使用 "1.0.0.0" 的值。 |
CreateDesktopShortcut |
選擇性的 Boolean 參數。如果為 true，ClickOnce 應用程式安裝期間會在桌面上建立一個圖示。 |
DeploymentUrl |
選擇性的 String 參數。指定應用程式的更新位置。 如果未指定此參數，就不會為應用程式定義任何更新位置。 不過，如果 UpdateEnabled 參數是 true，則必須指定更新位置。 指定的值應該是完整的 URL 或 UNC 路徑。 |
Description |
選擇性的 String 參數。指定應用程式的選擇性描述。 |
DisallowUrlActivation |
選擇性的 Boolean 參數。指定當應用程式透過 URL 開啟時，是否應該自動執行。 如果此參數為 true，應用程式只能從 [開始] 功能表啟動。 此參數的預設值為 false。 只有當 Install 參數值為 true 時，此輸入才適用。 |
EntryPoint |
選擇性的 ITaskItem[] 參數。指出所產生資訊清單組件的進入點。 對於 ClickOnce 部署資訊清單，此輸入會指定 ClickOnce 應用程式資訊清單。 如果 EntryPoint 工作參數未指定，<customHostSpecified> 標記會插入為 <entryPoint> 標記的子系，例如：<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2"><co.v1:customHostSpecified /></entryPoint>您可以使用下列步驟，將 DLL 相依性加入至應用程式資訊清單︰ 1.藉由呼叫 ResolveAssemblyReference 解析組件參考。 2.將上一個工作和組件本身的輸出傳遞至 ResolveManifestFiles。 3.使用 Dependencies 參數將相依性傳遞至 GenerateApplicationManifest。 |
ErrorReportUrl |
選擇性的 System.String 參數。 指定在 ClickOnce 安裝期間顯示於對話方塊中的網頁 URL。 |
InputManifest |
選擇性的 ITaskItem 參數。 指出要作為資訊清單產生器基底的輸入 XML 文件。 這能讓結構化資料 (例如自訂資訊清單定義) 反映在輸出資訊清單中。 XML 文件中的根元素必須是 asmv1 命名空間中的組件節點。 |
Install |
選擇性的 Boolean 參數。指定應用程式是已安裝的應用程式或是線上專用應用程式。 如果此參數為 true，應用程式將會安裝在使用者的 [開始] 功能表上，並可以使用 [新增或移除程式] 對話方塊予以移除。 如果此參數為 false，應用程式僅供從網頁線上使用。 此參數的預設值為 true。 |
MapFileExtensions |
選擇性的 Boolean 參數。指定是否要使用 .deploy 副檔名對應。 如果此參數為 true，每個程式檔都是以 .deploy 副檔名發行。 對於限制必須解除封鎖的副檔名數目，以啟用 ClickOnce 應用程式部署的網頁伺服器安全性，此選項很實用。 此參數的預設值為 false。 |
MaxTargetPath |
選擇性的 String 參數。指定 ClickOnce 應用程式部署中允許的檔案路徑長度上限。 如果指定此參數，則會根據此限制來檢查應用程式中的每個檔案路徑長度。 任何超過限制的項目都會造成建置警告。 如果這項輸入未指定或為零，則不會執行任何檢查。 |
MinimumRequiredVersion |
選擇性的 String 參數。指定使用者是否可以略過更新。 如果使用者的版本低於最小必要版本，則無法選擇略過更新。 當 Install 參數的值是 true 時，此輸入才適用。 |
OutputManifest |
選擇性的 ITaskItem 參數。 指定所產生的輸出資訊清單檔名稱。 如果未指定此參數，會從產生的資訊清單識別來推斷輸出檔的名稱。 |
Platform |
選擇性的 String 參數。指定應用程式的目標平台。 此參數的值如下： - AnyCPU- x86- x64- Itanium預設值是 AnyCPU。 |
Product |
選擇性的 String 參數。指定應用程式的名稱。 如果未指定此參數，會從產生的資訊清單識別來推斷名稱。 此名稱可用來作為 [開始] 功能表上的捷徑名稱，而且是出現在 [新增或移除程式] 對話方塊中名稱的一部分。 |
Publisher |
選擇性的 String 參數。指定應用程式的發行者。 如果未指定此參數，會從已註冊使用者或產生的資訊清單識別來推斷名稱。 此名稱可用來作為 [開始] 功能表上的資料夾名稱，而且是出現在 [新增或移除程式] 對話方塊中名稱的一部分。 |
SuiteNamel |
選擇性的 String 參數。指定在 ClickOnce 部署之後，[開始] 功能表上的應用程式所在的資料夾名稱。 |
SupportUrl |
選擇性的 String 參數。指定出現在 [新增或移除程式] 對話方塊中的應用程式連結。 指定的值應該是完整的 URL 或 UNC 路徑。 |
TargetCulture |
選擇性的 String 參數。識別應用程式的文化特性，並為產生的資訊清單指定組件識別的 Language 欄位。 如果未指定此參數，則會假設應用程式會因文化特性而異。 |
TrustUrlParameters |
選擇性的 Boolean 參數。指定應用程式是否可以使用 URL 查詢字串參數。 此參數的預設值是 false，表示應用程式無法使用該參數。 |
UpdateEnabled |
選擇性的 Boolean 參數。指出是否要讓應用程式進行更新。 此參數的預設值為 false。 當 Install 參數的值是 true 時，此參數才適用。 |
UpdateInterval |
選擇性的 Int32 參數。指定應用程式的更新間隔。 此參數的預設值為零。 當 Install 與 UpdateEnabled 參數的值都是 true 時，此參數才適用。 |
UpdateMode |
選擇性的 String 參數。指出應該先在前景檢查更新才啟動應用程式，或於執行應用程式時在背景更新。 此參數的值如下： - Foreground- Background此參數的預設值為 Background。 當 Install 與 UpdateEnabled 參數的值都是 true 時，此參數才適用。 |
UpdateUnit |
選擇性的 String 參數。指定 UpdateInterval 參數的單位。 此參數的值如下：- Hours- Days- Weeks當 Install 與 UpdateEnabled 參數的值都是 true 時，此參數才適用。 |
備註
除了上述所列的參數，此項工作還會繼承 GenerateManifestBase 類別中的參數，而該類別本身又繼承 Task 類別。 如需工作類別的參數清單，請參閱工作基底類別。