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

Статья
08/25/2023

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

Синтаксис

<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 следует использовать только в том случае, если один и тот же класс окна определяется параллельным компонентом и эквивалентным неопубликуемым компонентом и требуется рассматривать их как один и тот же класс окна. Обратите внимание, что обычные правила регистрации классов окон применяются— только первый компонент, регистрирующий класс окна, сможет зарегистрировать его, так как к ней не применяется версия.

Атрибут	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>

См. также

Манифест приложения ClickOnce

Поделиться через