Idioma

<elemento file> (aplicativo ClickOnce)

Identifica todos os arquivos não desmontados baixados e usados pelo aplicativo.

Sintaxe

<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>

Elementos e atributos

O elemento file é opcional. O elemento tem os seguintes atributos.

Attribute Description
name Required. Identifica o nome do arquivo.
size Required. Especifica o tamanho, em bytes, do arquivo.
group Opcional, se o optional atributo não for especificado ou definido como false; obrigatório se optional for true. O nome do grupo ao qual este arquivo pertence. O nome pode ser qualquer valor de cadeia de caracteres Unicode escolhido pelo desenvolvedor e é usado para baixar arquivos sob demanda com a ApplicationDeployment classe.
optional Optional. Especifica se esse arquivo deve ser baixado quando o aplicativo é executado pela primeira vez ou se o arquivo deve residir apenas no servidor até que o aplicativo o solicite sob demanda. Se false ou indefinido, o arquivo será baixado quando o aplicativo for executado pela primeira vez ou instalado. Se true, será group necessário especificar para que o manifesto do aplicativo seja válido. optional não pode ser true se writeableType for especificado com o valor applicationData.
writeableType Optional. Especifica que esse arquivo é um arquivo de dados. Atualmente, o único valor válido é applicationData.

typelib

O typelib elemento é um filho opcional do elemento de arquivo. O elemento descreve a biblioteca de tipos que pertence ao componente COM. O elemento tem os seguintes atributos.

Attribute Description
tlbid Required. O GUID atribuído à biblioteca de tipos.
version Required. O número de versão da biblioteca de tipos.
helpdir Required. O diretório que contém os arquivos de Ajuda para o componente. Pode ter comprimento zero.
resourceid Optional. A representação de cadeia de caracteres hexadecimal do identificador de localidade (LCID). É um a quatro dígitos hexadecimal sem um prefixo 0x e sem zeros à esquerda. O LCID pode ter um identificador de sublanguagem neutro.
flags Optional. A representação de cadeia de caracteres dos sinalizadores de biblioteca de tipos para essa biblioteca de tipos. Especificamente, ele deve ser um de "RESTRICTED", "CONTROL", "HIDDEN" e "HASDISKIMAGE".

comClass

O comClass elemento é um filho opcional do file elemento, mas é necessário se o aplicativo ClickOnce contiver um componente COM que pretende implantar usando COM sem registro. O elemento tem os seguintes atributos.

Attribute Description
clsid Required. A ID de classe do componente COM expressa como GUID.
description Optional. O nome da classe.
threadingModel Optional. O modelo de threading usado por classes COM em processo. Se essa propriedade for nula, nenhum modelo de threading será usado. O componente é criado no thread principal do cliente e as chamadas de outros threads são empacotadas para esse thread. A lista a seguir mostra os valores válidos:

Apartment, Free, Both e Neutral.
tlbid Optional. GUID para a biblioteca de tipos para este componente COM.
progid Optional. Identificador programático dependente de versão associado ao componente COM. O formato de a ProgID é <vendor>.<component>.<version>.
miscStatus Optional. Duplica no manifesto do assembly as informações fornecidas pela chave do MiscStatus Registro. Se os valores dos miscStatusIconatributos , ou , miscStatusThumbnailmiscStatusContentmiscStatusDocprintnão forem encontrados, o valor padrão correspondente listado miscStatus será usado para os atributos ausentes. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija MiscStatus valores de chave do Registro.
miscStatusIcon Optional. Duplica no assembly as informações fornecidas pelo DVASPECT_ICON. Ele pode fornecer um ícone de um objeto. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija Miscstatus valores de chave do Registro.
miscStatusContent Optional. Duplica no assembly as informações fornecidas pelo DVASPECT_CONTENT. Ele pode fornecer um documento composto que pode ser exibido para uma tela ou impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija MiscStatus valores de chave do Registro.
miscStatusDocPrint Optional. Duplica no manifesto do assembly as informações fornecidas pelo DVASPECT_DOCPRINT. Ele pode fornecer uma representação de objeto exibivel na tela como se fosse impressa em uma impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija MiscStatus valores de chave do Registro.
miscStatusThumbnail Optional. Duplica em um assembly as informações fornecidas pelo DVASPECT_THUMBNAIL. Ele pode fornecer uma miniatura de um objeto que pode ser exibido em uma ferramenta de navegação. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija MiscStatus valores de chave do Registro.

comInterfaceExternalProxyStub

O comInterfaceExternalProxyStub elemento é um filho opcional do file elemento, mas pode ser necessário se o aplicativo ClickOnce contiver um componente COM que pretende implantar usando COM sem registro. O elemento contém os atributos a seguir.

Attribute Description
iid Required. A ID da interface (IID) que é atendida por esse proxy. A IID deve ter chaves ao seu redor.
baseInterface Optional. A IID da interface da qual a interface referenciada é derivada iid .
numMethods Optional. O número de métodos implementados pela interface.
name Optional. O nome da interface como ela aparecerá no código.
tlbid Optional. A biblioteca de tipos que contém a descrição da interface especificada pelo iid atributo.
proxyStubClass32 Optional. Mapeia uma IID para um CLSID em DLLs de proxy de 32 bits.

comInterfaceProxyStub

O comInterfaceProxyStub elemento é um filho opcional do file elemento, mas pode ser necessário se o aplicativo ClickOnce contiver um componente COM que pretende implantar usando COM sem registro. O elemento contém os atributos a seguir.

Attribute Description
iid Required. A ID da interface (IID) que é atendida por esse proxy. A IID deve ter chaves ao seu redor.
baseInterface Optional. A IID da interface da qual a interface referenciada é derivada iid .
numMethods Optional. O número de métodos implementados pela interface.
Name Optional. O nome da interface como ela aparecerá no código.
Tlbid Optional. A biblioteca de tipos que contém a descrição da interface especificada pelo iid atributo.
proxyStubClass32 Optional. Mapeia uma IID para um CLSID em DLLs de proxy de 32 bits.
threadingModel Optional. Optional. O modelo de threading usado por classes COM em processo. Se essa propriedade for nula, nenhum modelo de threading será usado. O componente é criado no thread principal do cliente e as chamadas de outros threads são empacotadas para esse thread. A lista a seguir mostra os valores válidos:

Apartment, Free, Both e Neutral.

windowClass

O windowClass elemento é um filho opcional do file elemento, mas pode ser necessário se o aplicativo ClickOnce contiver um componente COM que pretende implantar usando COM sem registro. O elemento refere-se a uma classe de janela definida pelo componente COM que deve ter uma versão aplicada a ela. O elemento contém os atributos a seguir.

Attribute Description
versioned Optional. Controla se o nome da classe de janela interna usada no registro contém a versão do assembly que contém a classe de janela. O valor desse atributo pode ser yes ou no. O padrão é yes. O valor no só deverá ser usado se a mesma classe de janela for definida por um componente lado a lado e um componente não lado a lado equivalente e você quiser tratá-los como a mesma classe de janela. Observe que as regras usuais sobre o registro de classe de janela se aplicam– somente o primeiro componente que registra a classe de janela poderá registrá-la, pois ela não tem uma versão aplicada a ela.

hash

O hash elemento é um filho opcional do file elemento. O hash elemento não tem atributos.

O ClickOnce usa um hash algorítmico de todos os arquivos em um aplicativo como uma verificação de segurança, para garantir que nenhum dos arquivos tenha sido alterado após a implantação. Se o hash elemento não estiver incluído, essa verificação não será executada. Portanto, não é recomendável omitir o hash elemento.

Se um manifesto contiver um arquivo que não tenha hash, esse manifesto não poderá ser assinado digitalmente, pois os usuários não poderão verificar o conteúdo de um arquivo com hash.

dsig:Transforms

O dsig:Transforms elemento é um filho necessário do hash elemento. O dsig:Transforms elemento não tem atributos.

dsig:Transform

O dsig:Transform elemento é um filho necessário do dsig:Transforms elemento. O dsig:Transform elemento tem os seguintes atributos.

Attribute Description
Algorithm O algoritmo usado para calcular o resumo desse arquivo. Atualmente, o único valor usado pelo ClickOnce é urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

O dsig:DigestMethod elemento é um filho necessário do hash elemento. O dsig:DigestMethod elemento tem os seguintes atributos.

Attribute Description
Algorithm O algoritmo usado para calcular o resumo desse arquivo. Atualmente, o único valor usado pelo ClickOnce é http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

O dsig:DigestValue elemento é um filho necessário do hash elemento. O dsig:DigestValue elemento não tem atributos. Seu valor de texto é o hash computado para o arquivo especificado.

Observações

Esse elemento identifica todos os arquivos não desmontados que compõem o aplicativo e, em particular, os valores de hash para verificação de arquivo. Esse elemento também pode incluir dados de isolamento COM (Component Object Model) associados ao arquivo. Se um arquivo for alterado, o arquivo de manifesto do aplicativo também deverá ser atualizado para refletir a alteração.

Example

O exemplo de código a seguir ilustra elementos file em um manifesto de aplicativo para um aplicativo implantado usando 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>

Consulte também

  • Última atualização em