Idioma

<elemento de ficheiro> (aplicação ClickOnce)

Identifica todos os ficheiros não assembly descarregados e usados pela aplicação.

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 file elemento é opcional. O elemento tem as seguintes características.

Attribute Description
name Required. Identifica o nome do ficheiro.
size Required. Especifica o tamanho, em bytes, do ficheiro.
group Opcional, se o atributo optional não for especificado ou definido para false; required se optional for true. O nome do grupo a que este ficheiro pertence. O nome pode ser qualquer valor de string Unicode escolhido pelo programador e é usado para descarregar ficheiros sob demanda com a ApplicationDeployment classe.
optional Optional. Especifica se este ficheiro deve ser descarregado quando a aplicação é executada pela primeira vez, ou se o ficheiro deve residir apenas no servidor até que a aplicação o solicite a pedido. Se false for ou não definido, o ficheiro é descarregado quando a aplicação é executada ou instalada pela primeira vez. Se true, a group deve ser especificado para que o manifesto da aplicação seja válido. optional não pode ser verdadeiro se writeableType for especificado com o valor applicationData.
writeableType Optional. Especifica que este ficheiro é um ficheiro de dados. Atualmente, o único valor válido é applicationData.

typelib

O typelib elemento é um filho opcional do elemento do ficheiro. O elemento descreve a biblioteca de tipos que pertence ao componente COM. O elemento tem as seguintes características.

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 ficheiros de Ajuda do componente. Pode ser de comprimento zero.
resourceid Optional. A representação hexadecimal da cadeia do identificador local (LCID). São de um a quatro dígitos hexadecimais sem prefixo 0x e sem zeros à esquerda. O LCID pode ter um identificador neutro de sublinguagem.
flags Optional. A representação da cadeia de caracteres da biblioteca de tipos sinaliza esta biblioteca de tipos. Especificamente, deve ser um dos "RESTRICTED", "CONTROL", "HIDDEN" e "HASDISKIMAGE".

comClass

O comClass elemento é um filho opcional do file elemento, mas é obrigatório se a aplicação ClickOnce contiver um componente COM que pretende implementar usando COM sem registo. O elemento tem as seguintes características.

Attribute Description
clsid Required. O ID de classe do componente COM expresso como um GUID.
description Optional. O nome da classe.
threadingModel Optional. O modelo de threading utilizado pelas classes COM em processo. Se esta propriedade for nula, não é utilizado nenhum modelo de threading. O componente é criado no thread principal do cliente e as chamadas de outros threads são marshaladas para este thread. A lista seguinte mostra os valores válidos:

Apartment, Free, Both e Neutral.
tlbid Optional. GUID para a biblioteca de tipos deste componente COM.
progid Optional. Identificador programático dependente da versão associado ao componente COM. O formato de um ProgID é <vendor>.<component>.<version>.
miscStatus Optional. Duplicados no assembly manifestam a informação fornecida pela MiscStatus chave de registo. Se os valores para os miscStatusIconatributos , miscStatusContent, miscStatusDocprint, ou miscStatusThumbnail não forem encontrados, o valor padrão correspondente listado em miscStatus é usado para os atributos em falta. O valor pode ser uma lista delimitada por vírgulas dos valores dos atributos da tabela seguinte. Pode usar este atributo se a classe COM for uma classe OCX que requer MiscStatus valores de chave de registo.
miscStatusIcon Optional. Duplicados na assembleia manifestam a informação fornecida por DVASPECT_ICON. Pode fornecer um ícone de um objeto. O valor pode ser uma lista delimitada por vírgulas dos valores dos atributos da tabela seguinte. Pode usar este atributo se a classe COM for uma classe OCX que requer Miscstatus valores de chave de registo.
miscStatusContent Optional. Duplicados na assembleia manifestam a informação fornecida por DVASPECT_CONTENT. Pode fornecer um documento composto que pode ser exibido para um ecrã ou impressora. O valor pode ser uma lista delimitada por vírgulas dos valores dos atributos da tabela seguinte. Pode usar este atributo se a classe COM for uma classe OCX que requer MiscStatus valores de chave de registo.
miscStatusDocPrint Optional. Duplicados na assembleia manifestam a informação fornecida por DVASPECT_DOCPRINT. Pode fornecer uma representação do objeto exibível no ecrã como se fosse impressa numa impressora. O valor pode ser uma lista delimitada por vírgulas dos valores dos atributos da tabela seguinte. Pode usar este atributo se a classe COM for uma classe OCX que requer MiscStatus valores de chave de registo.
miscStatusThumbnail Optional. Duplicados numa assembleia manifestam a informação fornecida por DVASPECT_THUMBNAIL. Pode fornecer uma miniatura de um objeto exibível numa ferramenta de navegação. O valor pode ser uma lista delimitada por vírgulas dos valores dos atributos da tabela seguinte. Pode usar este atributo se a classe COM for uma classe OCX que requer MiscStatus valores de chave de registo.

comInterfaceExternalProxyStub

O comInterfaceExternalProxyStub elemento é um filho opcional do file elemento, mas pode ser necessário se a aplicação ClickOnce contiver um componente COM que pretende implementar usando COM sem registo. O elemento contém os seguintes atributos.

Attribute Description
iid Required. O ID da interface (IID) que é servido por este proxy. O IID deve ter aparelhos dentários à sua volta.
baseInterface Optional. O IID da interface a partir do qual a interface referenciada iid por é derivada.
numMethods Optional. O número de métodos implementados pela interface.
name Optional. O nome da interface tal como 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 um IID para um CLSID em DLLs proxy de 32 bits.

comInterfaceProxyStub

O comInterfaceProxyStub elemento é um filho opcional do file elemento, mas pode ser necessário se a aplicação ClickOnce contiver um componente COM que pretende implementar usando COM sem registo. O elemento contém os seguintes atributos.

Attribute Description
iid Required. O ID da interface (IID) que é servido por este proxy. O IID deve ter aparelhos dentários à sua volta.
baseInterface Optional. O IID da interface a partir do qual a interface referenciada iid por é derivada.
numMethods Optional. O número de métodos implementados pela interface.
Name Optional. O nome da interface tal como 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 um IID para um CLSID em DLLs proxy de 32 bits.
threadingModel Optional. Optional. O modelo de threading utilizado pelas classes COM em processo. Se esta propriedade for nula, não é utilizado nenhum modelo de threading. O componente é criado no thread principal do cliente e as chamadas de outros threads são marshaladas para este thread. A lista seguinte 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 a aplicação ClickOnce contiver um componente COM que pretende implementar usando COM sem registo. O elemento refere-se a uma classe janela definida pelo componente COM que deve ter uma versão aplicada. O elemento contém os seguintes atributos.

Attribute Description
versioned Optional. Controla se o nome interno da classe janela usado no registo contém a versão do assembly que contém a classe janela. O valor deste atributo pode ser yes ou no. A predefinição é yes. O valor no só deve ser usado se a mesma classe de janela estiver definida por um componente lado a lado e um componente equivalente não lado a lado e se quiser tratá-los como a mesma classe de janela. Note-se que as regras habituais sobre o registo da classe janela aplicam-se — apenas o primeiro componente que registar a classe janela poderá registá-la, porque não tem uma versão aplicada.

hash

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

O ClickOnce utiliza um hash algorítmico de todos os ficheiros de uma aplicação como verificação de segurança, para garantir que nenhum dos ficheiros foi alterado após a implementação. Se o hash elemento não for incluído, esta verificação não será realizada. Por isso, não é recomendado omitir o hash elemento.

Se um manifesto contiver um ficheiro que não está com hash, esse manifesto não pode ser assinado digitalmente, porque os utilizadores não podem verificar o conteúdo de um ficheiro sem hash.

dsig:Transforma

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

dsig:Transformar

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

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

dsig:DigestMethod

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

Attribute Description
Algorithm O algoritmo usado para calcular o digest deste ficheiro. 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 do hash elemento. O dsig:DigestValue elemento não tem atributos. O seu valor de texto é o hash calculado para o ficheiro especificado.

Remarks

Este elemento identifica todos os ficheiros não assembly que compõem a aplicação e, em particular, os valores de hash para verificação de ficheiros. Este elemento pode também incluir dados de isolamento do Component Object Model (COM) associados ao ficheiro. Se um ficheiro mudar, o ficheiro do manifesto da aplicação também deve ser atualizado para refletir a alteração.

Exemplo

O exemplo de código seguinte ilustra file elementos num manifesto de aplicação para uma aplicação implementada usando o 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>

Ver também

  • Última atualização a