включение файла данных в приложение ClickOnce

Каждое установленное приложение ClickOnce назначается каталог данных на локальном диске конечного компьютера, где приложение может управлять собственными данными. Файлы данных могут включать файлы любого типа: текстовые файлы, XML-файлы или даже файлы базы данных Microsoft Access (MDB). В следующих процедурах показано, как добавить файл данных любого типа в приложение ClickOnce.

Примечание.

В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии используйте dotnet-mage.exe вместо Mage.exe. Дополнительные сведения см. в разделе ClickOnce для .NET.

Включение файла данных с помощью Mage.exe

  1. Добавьте файл данных в каталог приложения с остальными файлами приложения.

    Как правило, каталог приложения будет каталогом, помеченным текущей версией развертывания, например версии 1.0.0.0.0.

  2. Обновите манифест приложения, чтобы получить список файла данных.

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

    Выполнение этой задачи повторно создает список файлов в манифесте приложения, а также автоматически создает хэш-подписи.

  3. Откройте манифест приложения в предпочитаемом текстовом или XML-редакторе и найдите file элемент для недавно добавленного файла.

    Если вы добавили XML-файл с именем Data.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. Как правило, каталог приложения будет каталогом, помеченным текущей версией развертывания, например версии 1.0.0.0.0.

  3. В меню "Файл" нажмите кнопку "Открыть", чтобы открыть манифест приложения.

  4. Перейдите на вкладку "Файлы ".

  5. В текстовом поле в верхней части вкладки введите каталог, содержащий файлы приложения, и нажмите кнопку "Заполнить".

    Файл данных появится в сетке.

  6. Задайте для файла данных значение "Тип файла данных".

  7. Сохраните манифест приложения, а затем повторно зарегистрируйте файл.

    MageUI.exe предложит повторно подписать файл.

  8. Повторно подписывание манифеста развертывания

    Необходимо повторно подписать манифест развертывания, так как его хэш манифеста приложения изменился.