<file> Elemento (aplicativo deClickOnce )

Artigo
08/04/2011

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 o optional atributo não for especificado ou definido como false; necessário se optional é 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 fazer o download de 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 o solicita sob demanda. Se false ou indefinido, o arquivo é descarregado quando o aplicativo é executado ou instalado pela primeira vez. 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 de arquivo. 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). É 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 a biblioteca de tipos. Especificamente, ele deve ser um dos "Restrito", "Controle", "Oculto" e "hasdiskimage".

comClass

O comClass elemento é um filho opcional de 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, os, e neutro.
tlbid	Opcional. GUID para a biblioteca de tipos para esse componente COM.
progid	Opcional. Identificador de programação dependente de versão associado com o componente COM. O formato de um ProgID é <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 encontradas, o valor correspondente do padrão listado na miscStatus é usado para atributos ausentes. O valor pode ser uma lista delimitada por ponto-e-vírgula dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX requer MiscStatus valores de 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 ponto-e-vírgula dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX requer Miscstatus valores de 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 ponto-e-vírgula dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX requer MiscStatus valores de 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 ponto-e-vírgula dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX requer MiscStatus valores de 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 ponto-e-vírgula dos valores de atributo da tabela a seguir. Você pode usar esse atributo, se a classe COM é uma classe OCX requer MiscStatus valores de chave do registro.

comInterfaceExternalProxyStub

O comInterfaceExternalProxyStub elemento é um filho opcional de file elemento, mas pode ser necessário se o ClickOnce aplicativo contém um componente COM que pretende implantar usando sem registro com. 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 é derivada.
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 de file elemento, mas pode ser necessário se o ClickOnce aplicativo contém um componente COM que pretende implantar usando sem registro com. 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 é derivada.
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, os, e neutro.

windowClass

O windowClass elemento é um filho opcional de file elemento, mas pode ser necessário se o ClickOnce aplicativo contém um componente COM que pretende implantar usando sem registro com. 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 tem sem atributos.

ClickOnceusa um hash de algoritmo 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 está 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 é misturado, esse manifesto não pode ser digitalmente assinado, porque os usuários não é possível verificar o conteúdo de um arquivo de sem hash.

DSIG:TRANSFORMS

O dsig:Transforms elemento é um filho obrigatório a hash elemento. O dsig:Transforms elemento tem sem atributos.

DSIG:transform

O dsig:Transform elemento é um filho obrigatório a 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 a 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 a hash elemento. O dsig:DigestValue elemento tem sem atributos. Seu valor de texto é o hash computado para o arquivo especificado.

Comentários

Esse elemento identifica todos os arquivos de nonassembly que compõem o 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

ClickOnce Application Manifest

Compartilhar via