指定哪些檔案是由 ClickOnce 發佈
發佈 ClickOnce 應用程式時,專案中的所有必要檔案都會與應用程式一起部署。 必要檔案的預設集合取決於專案類型 (例如 Windows Forms 應用程式)。 在某些情況下,您可能不想要或不需要發佈特定檔案,或者可能想要根據條件安裝特定檔案。 Visual Studio 可讓您包含檔案、排除檔案、將檔案標示為資料檔案或必要條件,以及建立檔案群組進行條件式安裝。
ClickOnce 應用程式的檔案是在 [應用程式檔案] 對話方塊中管理,此對話方塊可從 [專案設計工具] 的 [發佈] 頁面存取。
一開始,有一個名為 (Required) 的單一檔案群組。 您可以建立其他檔案群組,並將檔案指派給這些檔案群組。 您無法變更應用程式執行所需檔案的下載群組。 例如,標示為資料檔案的應用程式 .exe 或檔案必須屬於 (Required) 群組。
檔案的預設發佈狀態值是以 (Auto) 標記。 例如,應用程式的 .exe 預設具有 Include (Auto) 的發佈狀態。
Build Action 屬性設定為 Content 的檔案會指定為應用程式檔案,且預設會標示為已包含。 可以包含、排除這些檔案,或將其標示為資料檔案。 例外狀況如下:
SQL Database (.mdf 和 .mdb) 檔案和 XML 檔案等資料檔案預設會標示為資料檔案。
當您新增參考時,元件 (.dll 檔案) 的參考會指定如下:如果 Copy Local 為 False,預設會將其標示為必要組件 (Prerequisite (Auto)),其在安裝應用程式之前必須存在於 GAC 中。 如果 Copy Local 為 True,則預設會將組件標示為應用程式組件 (Include (Auto)),而且會在安裝時將其複製到應用程式資料夾。 只有在 Isolated 屬性設定為 True 時,COM 參考才會出現在 [應用程式檔案] 對話方塊中(作為 .ocx 檔案)。 根據預設,將會包含此參考。
將檔案新增至 [應用程式檔案] 對話方塊
在 [方案總管] 中選取資料檔案。
在 [屬性] 視窗中,將 Build Action 屬性變更為 Content 值。
從 ClickOnce 發佈中排除檔案
在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性] 。
按一下 [發佈] 索引標籤。
注意
在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET。
按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。
在 [應用程式檔案] 對話方塊中,選取您想要排除的檔案。
在 [發佈狀態] 欄位中,從下拉式清單中選取 [排除]。
將檔案標示為資料檔案
在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性] 。
按一下 [發佈] 索引標籤。
按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。
在 [應用程式檔案] 對話方塊中,選取您想要標示為資料的檔案。
在 [發佈狀態] 欄位中,從下拉式清單中選取 [資料檔案]。
將檔案標示為必要條件
在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性] 。
按一下 [發佈] 索引標籤。
按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。
在 [應用程式檔案] 對話方塊中,選取您想要將其標示為必要條件的應用程式組件 (.dll 檔案)。 請注意,您的應用程式必須具有應用程式組件的參考,才能出現在清單中。
在 [發佈狀態] 欄位中,從下拉式清單中選取 [必要條件]。
新增檔案群組
在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性] 。
按一下 [發佈] 索引標籤。
按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。
在 [應用程式檔案] 對話方塊中,為您要包含在新群組中的檔案選取 [群組] 欄位。
注意
這些檔案必須先將 Build Action 屬性設定為 Content,然後檔案名才會出現在 [應用程式檔案] 對話方塊中。
在 [下載群組] 欄位中,從下拉式清單中選取 [<新增...>]。
在 [新增群組] 對話方塊中,輸入群組的名稱,然後按一下 [確定]。
將檔案新增至群組
在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性] 。
按一下 [發佈] 索引標籤。
按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。
在 [應用程式檔案] 對話方塊中,為您要包含在新群組中的檔案選取 [群組] 欄位。
在 [下載群組] 欄位中,從下拉式清單中選取一個群組。
注意
您無法變更應用程式執行所需檔案的下載群組。