<arquivo>Elemento (aplicativo ClickOnce)

Artigo
08/25/2010

Identifica todos os arquivos 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

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

Atributo	Descrição
name	Obrigatório. Identifica o nome do arquivo.
size	Obrigatório. Especifica o dimensionar 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 agrupar 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 baixar quando o aplicativo está primeiro, ou se o arquivo deve residir apenas no servidor até que o aplicativo o solicita sob demanda. If False ou undefined, o arquivo é descarregado quando o aplicativo é executado ou instalado pela primeira vez. If true, um group deve ser especificado para o manifesto do aplicativo seja válido. optional nã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

The typelib elemento é um filho do elemento arquivo opcional. O elemento descreve qual pertence o componente COM biblioteca de tipos. O elemento tem os seguintes atributos.

Atributo	Descrição
tlbid	Obrigatório. O GUID atribuído para a 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 do componente. Podem ser nulas.
resourceid	Opcional. A representação de cadeia de caracteres hexadecimal do ID de localidade (LCID). É um a quatro dígitos hexadecimal sem prefixo 0 x e sem zeros entrelinhamento. O LCID pode ter um identificador de subidioma neutra.
flags	Opcional. A representação da cadeia de caracteres dos sinalizadores de biblioteca de tipo para esta biblioteca de tipos. Especificamente, ele deve ser uma das "RESTRICTED", "controle", "oculto" e "HASDISKIMAGE".

comClass

The comClass elemento é um filho opcional de file elemento, mas é necessário se o ClickOnce aplicativo contém um componente COM que pretende implantar usando disponível de inscrição COM. O elemento tem os seguintes atributos.

Atributo	Descrição
clsid	Obrigatório. A ID de classe do componente COM, expressa sistema autônomo um GUID.
description	Opcional. O nome de classe.
threadingModel	Opcional. O modelo de threading usado por classes de COM em processo. Se essa propriedade for nula, não será usado nenhum modelo de threading. O componente é criado no thread principal do cliente e as chamadas de outros segmentos são empacotadas para esse segmento. A lista a seguir mostra os valores válido: apartment, disponível, Ambos, and Neutro.
tlbid	Opcional. GUID para a biblioteca de tipos para este componente COM.
progid	Opcional. Dependente de versão associado com o componente COM identificador programático. O formato de um ProgID é <vendor>.<component>.<version>.
miscStatus	Opcional. Reproduz no manifesto do assembly as informações fornecidas pelo MiscStatus chave do registro. Se os valores para o miscStatusIcon, miscStatusContent, miscStatusDocprint, ou miscStatusThumbnail atributos não são encontrados, o valor padrão correspondentes listados na miscStatus é usado para a ausência de atributos. O valor pode ser uma lista separada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar este atributo se a classe COM é uma classe OCX que requer MiscStatus valores da chave do registro.
miscStatusIcon	Opcional. Reproduz no manifesto do assembly as informações fornecidas pelo DVASPECT_ICON. Ele pode fornecer um ícone de um objeto. O valor pode ser uma lista separada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar este atributo se a classe COM é uma classe OCX que requer Miscstatus valores da chave do registro.
miscStatusContent	Opcional. Reproduz no manifesto do assembly as informações fornecidas pelo DVASPECT_CONTENT. Ele pode fornecer um documento composto exibível para uma tela ou impressora. O valor pode ser uma lista separada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar este atributo se a classe COM é uma classe OCX que requer MiscStatus valores da chave do registro.
miscStatusDocPrint	Opcional. Reproduz no manifesto do assembly as informações fornecidas pelo DVASPECT_DOCPRINT. Ele pode fornecer uma representação de objeto de exibição na tela, sistema autônomo se impresso em uma impressora. O valor pode ser uma lista separada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar este atributo se a classe COM é uma classe OCX que requer MiscStatus valores da chave do registro.
miscStatusThumbnail	Opcional. As informações fornecidas pelo DVASPECT_THUMBNAIL de manifesto de duplicatas em um assembly. Ele pode fornecer uma miniatura de um objeto de exibição em uma ferramenta de navegação. O valor pode ser uma lista separada por vírgulas dos valores de atributo da tabela a seguir. Você pode usar este atributo se a classe COM é uma classe OCX que requer MiscStatus valores da chave do registro.

comInterfaceExternalProxyStub

The 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 disponível de inscrição COM. O elemento contém os seguintes atributos.

Atributo	Descrição
iid	Obrigatório. A interface ID (IID) que é servido por esse proxy. A IID deve ter 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 sistema autônomo ela aparecerá no código.
tlbid	Opcional. A biblioteca de tipos que contém a descrição da interface especificado pelo iid atributo.
proxyStubClass32	Opcional. Mapeia um IID para um CLSID no proxy de 32 bit DLLs.

comInterfaceProxyStub

The 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 disponível de inscrição COM. O elemento contém os seguintes atributos.

Atributo	Descrição
iid	Obrigatório. A interface ID (IID) que é servido por esse proxy. A IID deve ter 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 sistema autônomo ela aparecerá no código.
Tlbid	Opcional. A biblioteca de tipos que contém a descrição da interface especificado pelo iid atributo.
proxyStubClass32	Opcional. Mapeia um IID para um CLSID no proxy de 32 bit DLLs.
threadingModel	Opcional. Opcional. O modelo de threading usado por classes de COM em processo. Se essa propriedade for nula, não será usado nenhum modelo de threading. O componente é criado no thread principal do cliente e as chamadas de outros segmentos são empacotadas para esse segmento. A lista a seguir mostra os valores válido: apartment, disponível, Ambos, and Neutro.

windowClass

The 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 disponível de inscrição 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 nome usado no inscrição 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 or não. O padrão é Sim. O valor não deve ser usado somente se a mesma classe de janela é definida por um componente do lado a lado e um componente não--lado a lado equivalente e você deseja tratá-los sistema autônomo a mesma classe de janela. Observe que as regras comuns sobre o inscrição de classe de janela aplicam-se — somente o primeiro componente que registra a classe de janela poderá registrá-lo, porque não tem uma versão aplicada a ele.

versioned

Opcional. Se a janela interna nome usado no inscrição 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 or não. O padrão é Sim. O valor não deve ser usado somente se a mesma classe de janela é definida por um componente do lado a lado e um componente não--lado a lado equivalente e você deseja tratá-los sistema autônomo a mesma classe de janela. Observe que as regras comuns sobre o inscrição de classe de janela aplicam-se — somente o primeiro componente que registra a classe de janela poderá registrá-lo, porque não tem uma versão aplicada a ele.

hash

The hash elemento é um filho opcional de file elemento. The hash elemento tem sem atributos.

ClickOnce usa um hash algorítmico de todos sistema autônomo arquivos em um aplicativo sistema autônomo uma verificação de segurança para garantir que nenhum dos arquivos foram alterados após a implantação. Se o 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 é misturado, esse manifesto não pode ser digitalmente assinado, porque os usuários não podem verificar o Sumário de um arquivo unhashed.

DSIG:Transforms

The dsig:Transforms elemento é um filho obrigatório o hash elemento. The dsig:Transforms elemento tem sem atributos.

DSIG:Transform

The dsig:Transform elemento é um filho obrigatório o dsig:Transforms elemento. The 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 por ClickOnce é urn: schemas - microsoft - com:HashTransforms.identidade.

DSIG:DigestMethod

The dsig:DigestMethod elemento é um filho obrigatório o hash elemento. The 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 por ClickOnce é http://www.w3.org/2000/09/xmldsig#SHA1.

DSIG:DigestValue

The dsig:DigestValue elemento é um filho obrigatório o hash elemento. The dsig:DigestValue elemento tem sem atributos. Seu valor de texto é o hash calculado para o arquivo especificado.

Comentários

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

Exemplo

O exemplo de código a seguir ilustra file elementos em um manifesto do aplicativo para um aplicativo implantado usando ClickOnce. Este exemplo de código faz parte de um exemplo maior fornecido para o Manifesto do aplicativo ClickOnce tópico.

  <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

Date	History	Motivo
Julho de 2008	Informações sobre o adicionadashash elemento.	Aprimoramento de informações.

Julho de 2008

Informações sobre o adicionadashash elemento.

Aprimoramento de informações.

Compartilhar via