Uwzględnianie pliku danych w aplikacji ClickOnce

Każda instalowana aplikacja ClickOnce ma przypisany katalog danych na dysku lokalnym komputera docelowego, na którym aplikacja może zarządzać własnymi danymi. Pliki danych mogą zawierać pliki dowolnego typu: pliki tekstowe, pliki XML, a nawet pliki bazy danych programu Microsoft Access (mdb). Poniższe procedury pokazują, jak dodać plik danych dowolnego typu do aplikacji ClickOnce.

Uwaga

W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej użyj polecenia dotnet-mage.exe zamiast narzędzia Mage.exe. Aby uzyskać więcej informacji, zobacz ClickOnce dla platformy .NET.

Aby dołączyć plik danych przy użyciu narzędzia Mage.exe

1. Dodaj plik danych do katalogu aplikacji z pozostałymi plikami aplikacji.

   Zazwyczaj katalog aplikacji będzie katalogiem oznaczonym bieżącą wersją wdrożenia — na przykład w wersji 1.0.0.0.

2. Zaktualizuj manifest aplikacji, aby wyświetlić listę plików danych.

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

   Wykonanie tego zadania spowoduje ponowne utworzenie listy plików w manifeście aplikacji, a także automatyczne wygenerowanie podpisów skrótu.

3. Otwórz manifest aplikacji w preferowanym tekście lub edytorze XML i znajdź file element ostatnio dodany plik.

   Jeśli dodano plik XML o nazwie Data.xml, plik będzie wyglądać podobnie do poniższego przykładu kodu.

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

4. Dodaj atrybut type do tego elementu i podaj go z wartością data.

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

5. Ponownie podpisać manifest aplikacji przy użyciu pary kluczy lub certyfikatu, a następnie ponownie podpisać manifest wdrożenia.

   Musisz ponownie podpisać manifest wdrożenia, ponieważ jego skrót manifestu aplikacji uległ zmianie.

   mage -s app manifest -cf cert_file -pwd password

   mage -u deployment manifest -appm app manifest

   mage -s deployment manifest -cf certfile -pwd password

Aby dołączyć plik danych przy użyciu narzędzia MageUI.exe

1. Dodaj plik danych do katalogu aplikacji z pozostałymi plikami aplikacji.

2. Zazwyczaj katalog aplikacji będzie katalogiem oznaczonym bieżącą wersją wdrożenia — na przykład w wersji 1.0.0.0.

3. W menu Plik kliknij pozycję Otwórz, aby otworzyć manifest aplikacji.

4. Wybierz kartę Pliki .

5. W polu tekstowym w górnej części karty wprowadź katalog zawierający pliki aplikacji, a następnie kliknij przycisk Wypełnij.

   Plik danych zostanie wyświetlony w siatce.

6. Ustaw wartość Typ pliku danych na Wartość Dane.

7. Zapisz manifest aplikacji, a następnie ponownie podpisać plik.

   Plik MageUI.exe wyświetli monit o ponowne podpisanie pliku.

8. Ponowne podpisywanie manifestu wdrożenia

   Musisz ponownie podpisać manifest wdrożenia, ponieważ jego skrót manifestu aplikacji uległ zmianie.

Powiązana zawartość

• Uzyskiwanie dostępu do danych lokalnych i zdalnych w aplikacjach ClickOnce