Elemento <fileAssociation> (aplicativo ClickOnce)

Identifica uma extensão de arquivo a ser associada ao aplicativo.

Sintaxe

<fileAssociation
    xmlns="urn:schemas-microsoft-com:clickonce.v1"
    extension
    description
    progid
    defaultIcon
/>

Elementos e atributos

O elemento fileAssociation é opcional. O elemento tem os atributos a seguir.

Atributo	Descrição
extension	Obrigatórios. A extensão de arquivo a ser associada ao aplicativo.
description	Obrigatórios. Uma descrição do tipo de arquivo a ser usado pelo shell.
progid	Obrigatórios. Um nome que identifica exclusivamente o tipo de arquivo.
defaultIcon	Obrigatórios. Especifica o ícone a ser usado para arquivos com essa extensão. O arquivo de ícone deve ser especificado usando o Elemento <file> no Elemento <assembly> que contém esse elemento.

Comentários

Esse elemento deve incluir uma referência de namespace XML para urn:schemas-microsoft-com:clickonce.v1. Se o elemento <fileAssociation> for usado, ele deverá vir após o elemento <application> em seu Elemento <assembly> pai.

O ClickOnce não substituirá as associações de arquivos existentes. No entanto, um aplicativo ClickOnce pode substituir a extensão de arquivo somente para o usuário atual. Depois que o aplicativo ClickOnce for desinstalado, o ClickOnce excluirá a associação de arquivos para o usuário, e a associação por computador estará ativa novamente.

Exemplo

O exemplo de código a seguir ilustra elementos fileAssociation em um manifesto do aplicativo para um aplicativo de editor de texto implantado usando o ClickOnce. Este exemplo de código também inclui o Elemento <file> exigido pelo atributo defaultIcon.

<file name="text.ico" size="4286">
  <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>0joAqhmfeBb93ZneZv/oTMP2brY=</dsig:DigestValue>
  </hash>
</file>
<file name="writing.ico" size="9662">
  <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>2cL2U7cm13nG40v9MQdxYKazIwI=</dsig:DigestValue>
  </hash>
</file>
<fileAssociation xmlns="urn:schemas-microsoft-com:clickonce.v1" extension=".text" description="Text  Document (ClickOnce)" progid="Text.Document" defaultIcon="text.ico" />
<fileAssociation xmlns="urn:schemas-microsoft-com:clickonce.v1" extension=".writing" description="Writings (ClickOnce)" progid="Writing.Document" defaultIcon="writing.ico" />

Confira também

• Manifesto do aplicativo ClickOnce