指定哪些檔案是由 ClickOnce 發佈

發佈 ClickOnce 應用程式時,專案中的所有非程式碼檔案都會與應用程式一起部署。 在某些情況下,您可能不想要或不需要發佈特定檔案,或者可能想要根據條件安裝特定檔案。 Visual Studio 可讓您排除檔案、將檔案標示為資料檔案或必要條件,以及建立檔案群組進行條件式安裝。

ClickOnce 應用程式的檔案是在 [應用程式檔案] 對話方塊中管理,此對話方塊可從 [專案設計工具] 的 [發佈] 頁面存取。

一開始,有一個名為 (Required) 的單一檔案群組。 您可以建立其他檔案群組,並將檔案指派給這些檔案群組。 您無法變更應用程式執行所需檔案的下載群組。 例如,標示為資料檔案的應用程式 .exe 或檔案必須屬於 (Required) 群組。

檔案的預設發佈狀態值是以 (Auto) 標記。 例如,應用程式的 .exe 預設具有 Include (Auto) 的發佈狀態。

Build Action 屬性設定為 Content 的檔案會指定為應用程式檔案,且預設會標示為已包含。 可以包含、排除這些檔案,或將其標示為資料檔案。 例外狀況如下:

  • SQL Database (.mdf.mdb) 檔案和 XML 檔案等資料檔案預設會標示為資料檔案。

  • 當您新增參考時,元件 (.dll 檔案) 的參考會指定如下:如果 Copy LocalFalse,預設會將其標示為必要組件 (Prerequisite (Auto)),其在安裝應用程式之前必須存在於 GAC 中。 如果 Copy LocalTrue,則預設會將組件標示為應用程式組件 (Include (Auto)),而且會在安裝時將其複製到應用程式資料夾。 只有在 Isolated 屬性設定為 True 時,COM 參考才會出現在 [應用程式檔案] 對話方塊中(作為 .ocx 檔案)。 根據預設,將會包含此參考。

將檔案新增至 [應用程式檔案] 對話方塊

  1. 在 [方案總管] 中選取資料檔案。

  2. 在 [屬性] 視窗中,將 Build Action 屬性變更為 Content 值。

從 ClickOnce 發佈中排除檔案

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

    注意

    在 ClickOnce for .NET Core 3.1 和 .NET 5 或更新版本中,您可以使用 [發佈] 工具來設定部署屬性,而不是 [發行精靈] 和 [專案設計工具的發佈] 頁面。 如需詳細資訊,請參閱使用 ClickOnce 部署 .NET Windows 應用程式以及 ClickOnce for .NET

  3. 按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。

  4. 在 [應用程式檔案] 對話方塊中,選取您想要排除的檔案。

  5. 在 [發佈狀態] 欄位中,從下拉式清單中選取 [排除]

將檔案標示為資料檔案

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

  3. 按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。

  4. 在 [應用程式檔案] 對話方塊中,選取您想要標示為資料的檔案。

  5. 在 [發佈狀態] 欄位中,從下拉式清單中選取 [資料檔案]

將檔案標示為必要條件

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

  3. 按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。

  4. 在 [應用程式檔案] 對話方塊中,選取您想要將其標示為必要條件的應用程式組件 (.dll 檔案)。 請注意,您的應用程式必須具有應用程式組件的參考,才能出現在清單中。

  5. 在 [發佈狀態] 欄位中,從下拉式清單中選取 [必要條件]

新增檔案群組

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

  3. 按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。

  4. 在 [應用程式檔案] 對話方塊中,為您要包含在新群組中的檔案選取 [群組] 欄位。

    注意

    這些檔案必須先將 Build Action 屬性設定為 Content,然後檔案名才會出現在 [應用程式檔案] 對話方塊中。

  5. 在 [下載群組] 欄位中,從下拉式清單中選取 [<新增...>]

  6. 在 [新增群組] 對話方塊中,輸入群組的名稱,然後按一下 [確定]

將檔案新增至群組

  1. 在方案總管 中選取專案之後,按一下 [專案] 功能表中 [屬性]

  2. 按一下 [發佈] 索引標籤。

  3. 按一下 [應用程式檔案] 按鈕,以開啟 [應用程式檔案] 對話方塊。

  4. 在 [應用程式檔案] 對話方塊中,為您要包含在新群組中的檔案選取 [群組] 欄位。

  5. 在 [下載群組] 欄位中,從下拉式清單中選取一個群組。

    注意

    您無法變更應用程式執行所需檔案的下載群組