Share via

<элемент file> (приложение ClickOnce)

  • Статья

Идентифицирует все скачанные и используемые приложением файлы, не относящиеся к сборке.

Синтаксис

<file
    name
    size
    group
    optional
    writeableType
>
    <typelib
        tlbid
        version
        helpdir
        resourceid
        flags
    />
    <comClass
        clsid
        description
        threadingModel
        tlbid
        progid
        miscStatus
        miscStatusIcon
        miscStatusContent
        miscStatusDocPrint
        miscStatusThumbnail
    />
    <comInterfaceExternalProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <comInterfaceProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <windowClass
        versioned
    />
</file>

Элементы и атрибуты

Элемент file необязательный. Элемент имеет перечисленные ниже атрибуты.

Атрибут Description
name Обязательное. Определяет имя файла.
size Обязательно. Задает размер файла в байтах.
group Необязательный атрибут, если optional атрибут не указан или задан falseв значение ; обязательный, если optional имеет значение true. Имя группы, к которой принадлежит этот файл. Имя может быть любым строковым значением Юникода, выбранным разработчиком, и используется для скачивания файлов по запросу с классом ApplicationDeployment .
optional Необязательно. Указывает, должен ли этот файл скачивать при первом запуске приложения или должен ли файл находиться только на сервере, пока приложение не запрашивает его по запросу. Если false или не определено, файл загружается при первом запуске или установке приложения. Если trueдля group манифеста приложения необходимо указать допустимое значение. optional значение не может быть true, если writeableType задано значение applicationData.
writeableType Необязательно. Указывает, что этот файл является файлом данных. В настоящее время единственным допустимым значением является applicationData.

Typelib

Элемент typelib является необязательным дочерним элементом элемента file. Элемент описывает библиотеку типов, принадлежащую компоненту COM. Элемент имеет перечисленные ниже атрибуты.

Атрибут Description
tlbid Обязательное. GUID, назначенный библиотеке типов.
version Обязательно. Номер версии библиотеки типов.
helpdir Обязательно. Каталог, содержащий файлы справки для компонента. Может быть нулевой длиной.
resourceid Необязательно. Шестнадцатеричное строковое представление идентификатора языкового стандарта (LCID). Это один до четырех шестнадцатеричных цифр без префикса 0x и без начальных нулей. LCID может иметь нейтральный идентификатор подлангуга.
flags Необязательно. Строковое представление флагов библиотеки типов для этой библиотеки типов. В частности, он должен быть одним из "RESTRICTED", "CONTROL", "HIDDEN" и "HASDISKIMAGE".

comClass

Элемент comClass является необязательным дочерним file элементом элемента, но требуется, если приложение ClickOnce содержит COM-компонент, который он намерен развернуть с помощью COM-файла без регистрации. Элемент имеет перечисленные ниже атрибуты.

Атрибут Description
clsid Обязательное. Идентификатор класса компонента COM, выраженный как GUID.
description Необязательно. Имя класса.
threadingModel Необязательно. Модель потоков, используемая классами COM в процессе. Если это свойство равно NULL, модель потоков не используется. Компонент создается на основном потоке клиента и вызовы из других потоков маршалируются в этот поток. В следующем списке показаны допустимые значения:

Apartment, Free, Both и Neutral.
tlbid Необязательно. GUID для библиотеки типов для этого com-компонента.
progid Необязательно. Программный идентификатор, зависящий от версии, связанный с com-компонентом. Формат объекта ProgID<vendor>.<component>.<version>.
miscStatus Необязательно. Дублирует в манифесте сборки сведения, предоставленные разделом MiscStatus реестра. Если значения для miscStatusIconатрибутов , miscStatusContentили miscStatusDocprintmiscStatusThumbnail атрибутов не найдены, для отсутствующих атрибутов используется соответствующее значение miscStatus по умолчанию. Значение может быть разделенным запятыми значений атрибутов из следующей таблицы. Этот атрибут можно использовать, если класс COM является классом OCX, который требует MiscStatus значений разделов реестра.
miscStatusIcon Необязательно. Дублирует данные в манифесте сборки, предоставляемые DVASPECT_ICON. Он может предоставить значок объекта. Значение может быть разделенным запятыми значений атрибутов из следующей таблицы. Этот атрибут можно использовать, если класс COM является классом OCX, который требует Miscstatus значений разделов реестра.
miscStatusContent Необязательно. Дублирует данные в манифесте сборки, предоставляемые DVASPECT_CONTENT. Он может предоставить составной документ, отображаемый для экрана или принтера. Значение может быть разделенным запятыми значений атрибутов из следующей таблицы. Этот атрибут можно использовать, если класс COM является классом OCX, который требует MiscStatus значений разделов реестра.
miscStatusDocPrint Необязательно. Дублирует в манифесте сборки сведения, предоставленные DVASPECT_DOCPRINT. Он может предоставить представление объекта, отображаемое на экране, как если бы оно было напечатано на принтере. Значение может быть разделенным запятыми значений атрибутов из следующей таблицы. Этот атрибут можно использовать, если класс COM является классом OCX, который требует MiscStatus значений разделов реестра.
miscStatusThumbnail Необязательно. Дублирует в манифесте сборки сведения, предоставляемые DVASPECT_THUМБ NAIL. Он может предоставить эскиз объекта, отображаемого в средстве просмотра. Значение может быть разделенным запятыми значений атрибутов из следующей таблицы. Этот атрибут можно использовать, если класс COM является классом OCX, который требует MiscStatus значений разделов реестра.

comInterfaceExternalProxyStub

Элемент comInterfaceExternalProxyStub является необязательным дочерним file элементом элемента, но может потребоваться, если приложение ClickOnce содержит COM-компонент, который он намерен развернуть с помощью COM-файла без регистрации. Элемент содержит следующие атрибуты.

Атрибут Description
iid Обязательное. Идентификатор интерфейса (IID), обслуживаемый этим прокси-сервером. IID должен иметь скобки вокруг него.
baseInterface Необязательно. IID интерфейса, на который ссылается iid интерфейс, производный от него.
numMethods Необязательно. Количество методов, реализованных интерфейсом.
name Необязательно. Имя интерфейса, как оно будет отображаться в коде.
tlbid Необязательно. Библиотека типов, содержащая описание интерфейса, указанного атрибутом iid .
proxyStubClass32 Необязательно. Карты iiD в CLSID в 32-разрядных библиотеках DLL прокси-сервера.

comInterfaceProxyStub

Элемент comInterfaceProxyStub является необязательным дочерним file элементом элемента, но может потребоваться, если приложение ClickOnce содержит COM-компонент, который он намерен развернуть с помощью COM-файла без регистрации. Элемент содержит следующие атрибуты.

Атрибут Description
iid Обязательное. Идентификатор интерфейса (IID), обслуживаемый этим прокси-сервером. IID должен иметь скобки вокруг него.
baseInterface Необязательно. IID интерфейса, на который ссылается iid интерфейс, производный от него.
numMethods Необязательно. Количество методов, реализованных интерфейсом.
Name Необязательно. Имя интерфейса, как оно будет отображаться в коде.
Tlbid Необязательно. Библиотека типов, содержащая описание интерфейса, указанного атрибутом iid .
proxyStubClass32 Необязательно. Карты iiD в CLSID в 32-разрядных библиотеках DLL прокси-сервера.
threadingModel Необязательно. Необязательно. Модель потоков, используемая классами COM в процессе. Если это свойство равно NULL, модель потоков не используется. Компонент создается на основном потоке клиента и вызовы из других потоков маршалируются в этот поток. В следующем списке показаны допустимые значения:

Apartment, Free, Both и Neutral.

windowClass

Элемент windowClass является необязательным дочерним file элементом элемента, но может потребоваться, если приложение ClickOnce содержит COM-компонент, который он намерен развернуть с помощью COM-файла без регистрации. Элемент ссылается на класс окна, определенный компонентом COM, который должен применяться к нему версией. Элемент содержит следующие атрибуты.

Атрибут Description
versioned Необязательно. Определяет, содержит ли имя внутреннего класса окна, используемое в регистрации, версию сборки, содержащей класс окна. Значение этого атрибута может быть yes или no. Значение по умолчанию — yes. Значение no следует использовать только в том случае, если один и тот же класс окна определяется параллельным компонентом и эквивалентным неопубликуемым компонентом и требуется рассматривать их как один и тот же класс окна. Обратите внимание, что обычные правила регистрации классов окон применяются— только первый компонент, регистрирующий класс окна, сможет зарегистрировать его, так как к ней не применяется версия.

hash

Элемент hash является необязательным дочерним элементом file элемента. У элемента hash нет атрибутов.

ClickOnce использует алгоритмический хэш всех файлов в приложении в качестве проверка безопасности, чтобы убедиться, что ни один из файлов не был изменен после развертывания. hash Если элемент не включен, этот проверка не будет выполнен. Поэтому не рекомендуется пропускать hash элемент.

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

dsig:Transforms

Элемент dsig:Transforms является обязательным дочерним элементом hash элемента. У элемента dsig:Transforms нет атрибутов.

dsig:Transform

Элемент dsig:Transform является обязательным дочерним элементом dsig:Transforms элемента. Элемент dsig:Transform имеет перечисленные ниже атрибуты.

Атрибут Description
Algorithm Алгоритм, используемый для вычисления дайджеста для этого файла. В настоящее время единственным значением, используемым ClickOnce, является urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Элемент dsig:DigestMethod является обязательным дочерним элементом hash элемента. Элемент dsig:DigestMethod имеет перечисленные ниже атрибуты.

Атрибут Description
Algorithm Алгоритм, используемый для вычисления дайджеста для этого файла. В настоящее время единственным значением, используемым ClickOnce, является http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Элемент dsig:DigestValue является обязательным дочерним элементом hash элемента. У элемента dsig:DigestValue нет атрибутов. Его текстовое значение — вычисляемый хэш для указанного файла.

Замечания

Этот элемент определяет все несассемблированные файлы, составляющие приложение, и, в частности, хэш-значения для проверки файлов. Этот элемент также может включать данные изоляции компонентной объектной модели (COM), связанные с файлом. Если файл изменяется, файл манифеста приложения также необходимо обновить, чтобы отразить это изменение.

Пример

В следующем примере кода показаны file элементы манифеста приложения для приложения, развернутого с помощью ClickOnce.

<file name="Icon.ico" size="9216">
  <hash>
    <dsig:Transforms>
      <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
    </dsig:Transforms>
    <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
    <dsig:DigestValue>lVoj+Rh6RQ/HPNLOdayQah5McrI=</dsig:DigestValue>
  </hash>
</file>

См. также