Elemento <file>(aplicativo ClickOnce)

Artigo
06/10/2015

Identifica todos os arquivos de nonassembly baixado e usado pelo aplicativo.

<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 file elemento é opcional. O elemento tem os seguintes atributos.

Atributo	Descrição
name	Obrigatório. Identifica o nome do arquivo.
size	Obrigatório. Especifica o tamanho, em bytes, do arquivo.
group	Opcional, se a optional atributo não for especificado ou definido como false; required if optional is true. O nome do grupo ao qual este arquivo pertence. O nome pode ser qualquer valor de seqüência de caracteres Unicode escolhido pelo desenvolvedor e é usado para baixar os arquivos sob demanda com o ApplicationDeployment classe.
optional	Opcional. Especifica se este arquivo deve executar o download quando o aplicativo é o primeiro ou se o arquivo deve residir apenas no servidor até que o aplicativo solicita-lo sob demanda. Se false ou não definido, o arquivo é descarregado quando o aplicativo é executado pela primeira vez ou instalado. Se true, um group deve ser especificado para o manifesto do aplicativo seja válido. optionalnão pode ser true se writeableType é especificado com o valor applicationData.
writeableType	Opcional. Especifica que este arquivo é um arquivo de dados. Atualmente o único valor válido é applicationData.

TypeLib

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

Atributo	Descrição
tlbid	Obrigatório. O GUID atribuído à biblioteca de tipos.
version	Obrigatório. O número de versão da biblioteca de tipos.
helpdir	Obrigatório. O diretório que contém os arquivos de ajuda para o componente. Talvez o comprimento zero.
resourceid	Opcional. A representação de seqüência hexadecimal do identificador de localidade (LCID). Ele é um a quatro dígitos hexadecimal sem um prefixo 0x e sem zeros à esquerda. O LCID pode ter um identificador de subidioma neutra.
flags	Opcional. A representação de seqüência de caracteres dos sinalizadores de biblioteca de tipo para esta biblioteca de tipos. Especificamente, ele deve ser um dos "Restrito", "Controle", "Oculto" e "HASDISKIMAGE".

comClass

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

Atributo	Descrição
clsid	Obrigatório. A identificação de classe do componente COM expresso como um GUID.
description	Opcional. O nome da classe.
threadingModel	Opcional. O modelo de threading usado por classes de COM em processo. Se essa propriedade for null, nenhum modelo de threading é usado. O componente é criado no thread principal do cliente e chamadas de outros segmentos são empacotadas para esse segmento. A lista a seguir mostra os valores válidos: Apartamento, livre, ambos os, e neutro.
tlbid	Opcional. GUID para a biblioteca de tipos para esse componente COM.
progid	Opcional. Dependente de versão identificador programático associado com o componente COM. The format of a ProgID is <vendor>.<component>.<version>.
miscStatus	Opcional. As informações fornecidas pelo manifestam de duplicatas na montagem de MiscStatus chave do registro. Se os valores para o miscStatusIcon, miscStatusContent, miscStatusDocprint, ou miscStatusThumbnail atributos não forem encontrados, o valor correspondente do padrão listados na miscStatus é usado para a ausência de atributos. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX que requer MiscStatus valores chave do registro.
miscStatusIcon	Opcional. As informações fornecidas por DVASPECT_ICON de manifesto de duplicatas no assembly. 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ê pode usar esse atributo, se a classe COM é uma classe OCX que requer Miscstatus valores chave do registro.
miscStatusContent	Opcional. As informações fornecidas por DVASPECT_CONTENT de manifesto de duplicatas no assembly. Ele pode fornecer um exibição de documento composto para uma tela ou impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX que requer MiscStatus valores chave do registro.
miscStatusDocPrint	Opcional. As informações fornecidas por DVASPECT_DOCPRINT de manifesto de duplicatas no assembly. Ele pode fornecer uma representação de objeto exibição na tela, como se impresso em uma impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX que requer MiscStatus valores chave do registro.
miscStatusThumbnail	Opcional. As informações fornecidas por DVASPECT_THUMBNAIL de manifesto de duplicatas em um assembly. Ele pode fornecer uma miniatura de um objeto de exibição em uma ferramenta de procura. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX que requer MiscStatus valores chave do registro.

comInterfaceExternalProxyStub

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

Atributo	Descrição
iid	Obrigatório. A interface ID (IID) que é servido por esse proxy. O IID deve ter as chaves em torno dela.
baseInterface	Opcional. O IID da interface da qual a interface referenciada por iid é derivado.
numMethods	Opcional. O número de métodos implementados pela interface.
name	Opcional. O nome da interface como ele será exibido no código.
tlbid	Opcional. A biblioteca de tipos que contém a descrição da interface especificada pela iid atributo.
proxyStubClass32	Opcional. Mapeia um IID para um CLSID no proxy de 32 bits DLLs.

comInterfaceProxyStub

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

Atributo	Descrição
iid	Obrigatório. A interface ID (IID) que é servido por esse proxy. O IID deve ter as chaves em torno dela.
baseInterface	Opcional. O IID da interface da qual a interface referenciada por iid é derivado.
numMethods	Opcional. O número de métodos implementados pela interface.
Name	Opcional. O nome da interface como ele será exibido no código.
Tlbid	Opcional. A biblioteca de tipos que contém a descrição da interface especificada pela iid atributo.
proxyStubClass32	Opcional. Mapeia um IID para um CLSID no proxy de 32 bits DLLs.
threadingModel	Opcional. Opcional. O modelo de threading usado por classes de COM em processo. Se essa propriedade for null, nenhum modelo de threading é usado. O componente é criado no thread principal do cliente e chamadas de outros segmentos são empacotadas para esse segmento. A lista a seguir mostra os valores válidos: Apartamento, livre, ambos os, e neutro.

windowClass

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

Atributo	Descrição
versioned	Opcional. Se a janela interna usado no registro de nome da classe contém a versão do assembly que contém a classe de janela de controles. O valor desse atributo pode ser Sim ou sem. O padrão é Sim. O valor sem deve ser usado somente se a mesma classe de janela é definida por um componente do lado a lado e um componente de não-lado-a-lado equivalente e você deseja tratá-los como a mesma classe de janela. Observe que as regras usuais sobre registro de classe de janela aplicam — somente o primeiro componente que registra a classe de janela poderão registrá-lo, porque não tem uma versão aplicada a ele.

versioned

Opcional. Se a janela interna usado no registro de nome da classe contém a versão do assembly que contém a classe de janela de controles. O valor desse atributo pode ser Sim ou sem. O padrão é Sim. O valor sem deve ser usado somente se a mesma classe de janela é definida por um componente do lado a lado e um componente de não-lado-a-lado equivalente e você deseja tratá-los como a mesma classe de janela. Observe que as regras usuais sobre registro de classe de janela aplicam — somente o primeiro componente que registra a classe de janela poderão registrá-lo, porque não tem uma versão aplicada a ele.

hash

O hash elemento é um filho opcional de file elemento. O hash elemento não tem nenhum atributo.

ClickOnceusa um hash algorítmico de todos os arquivos em um aplicativo como uma verificação de segurança, para garantir que nenhum dos arquivos foram alterados após a implantação. Se a hash elemento não é incluído, essa verificação não será executada. Portanto, omitindo o hash elemento não é recomendado.

Se um manifesto contém um arquivo que não é especificada como hash, esse manifesto não pode ser digitalmente assinado, porque os usuários não é possível verificar o conteúdo de um arquivo sem hash.

DSIG:TRANSFORMS

O dsig:Transforms elemento é um filho obrigatório da hash elemento. O dsig:Transforms elemento não tem nenhum atributo.

DSIG:Transform

O dsig:Transform elemento é um filho obrigatório da dsig:Transforms elemento. O dsig:Transform elemento tem os seguintes atributos.

Atributo	Descrição
Algorithm	O algoritmo usado para calcular a compilação para este arquivo. Atualmente o único valor usado pelo ClickOnce é urn: schemas-microsoft-com:HashTransforms.Identity.

DSIG:DigestMethod

O dsig:DigestMethod elemento é um filho obrigatório da hash elemento. O dsig:DigestMethod elemento tem os seguintes atributos.

Atributo	Descrição
Algorithm	O algoritmo usado para calcular a compilação para este arquivo. Atualmente o único valor usado pelo ClickOnce é http://www.w3.org/2000/09/xmldsig#sha1.

DSIG:DigestValue

O dsig:DigestValue elemento é um filho obrigatório da hash elemento. O dsig:DigestValue elemento não tem nenhum atributo. Seu valor de texto é o hash computado para o arquivo especificado.

Comentários

Esse elemento identifica todos os arquivos nonassembly que fazem parte do aplicativo e, em particular, os valores de hash para verificação de arquivos. Esse elemento também pode incluir dados de isolamento do modelo de objeto componente (COM) associados ao arquivo. Se um arquivo for alterado, o arquivo de manifesto do aplicativo também deve ser atualizado para refletir a alteração.

Exemplo

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

Referência

Manifesto de aplicativo ClickOnce

Compartilhar via