在 ClickOnce 應用程式中納入資料檔案

  • 發行項

您安裝的每個 ClickOnce 應用程式都會在目的地電腦的本機磁碟上指派資料目錄，以便應用程式管理自己的資料。 資料檔案可以包含任何類型的檔案：文字檔、XML 檔案，甚至是 Microsoft Access 資料庫 (.mdb) 檔案。 下列程序示範如何將任何類型的資料檔案新增至 ClickOnce 應用程式。

注意

在 .NET Core 3.1 和 .NET 5 或更新版本的 ClickOnce 中使用 dotnet-mage.exe，而不是使用 Mage.exe。 如需詳細資訊，請參閱適用於 .NET 的 ClickOnce。

使用 Mage.exe 納入資料檔案

  1. 將資料檔案新增至您的應用程式目錄，其中包含應用程式的其餘檔案。

    一般而言，您的應用程式目錄會是以目前部署版本標示的目錄，例如 v1.0.0.0。

  2. 更新應用程式資訊清單以列出資料檔案。

    mage -u v1.0.0.0\Application.manifest -FromDirectory v1.0.0.0

    執行此工作會重新建立應用程式資訊清單中的檔案清單，並自動產生雜湊簽章。

  3. 在慣用的文字或 XML 編輯器中開啟應用程式資訊清單，並尋找您最近新增檔案的 file 元素。

    如果您新增了名為 Data.xml 的 XML 檔案，此檔案看起來會類似下列程式碼範例。

    <file name="Data.xml" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

  4. 將 type 屬性新增至這個元素，並提供 data 值給它。

    <file name="Data.xml" writeableType="applicationData" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

  5. 使用金鑰組或憑證重新簽署應用程式資訊清單，然後重新簽署部署資訊清單。

    您必須重新簽署部署資訊清單，因為其應用程式資訊清單的雜湊已變更。

    mage -s app manifest -cf cert_file -pwd password

    mage -u deployment manifest -appm app manifest

    mage -s deployment manifest -cf certfile -pwd password

使用 MageUI.exe 納入資料檔案

  1. 將資料檔案新增至您的應用程式目錄，其中包含應用程式的其餘檔案。

  2. 一般而言，您的應用程式目錄會是以目前部署版本標示的目錄，例如 v1.0.0.0。

  3. 在 [檔案] 功能表上，按一下 [開啟] 以開啟您的應用程式資訊清單。

  4. 按一下 [檔案] 索引標籤。

  5. 在索引標籤頂端的文字方塊中，輸入包含您應用程式檔案的目錄，然後按一下 [填入]。

    您的資料檔案會出現在方格中。

  6. 將資料檔案的 [檔案類型] 值設定為 [資料]。

  7. 儲存應用程式資訊清單，然後重新簽署檔案。

    MageUI.exe 會提示您重新簽署檔案。

  8. 重新簽署部署資訊清單

    您必須重新簽署部署資訊清單，因為其應用程式資訊清單的雜湊已變更。

相關內容