Share via

Criar associações de arquivos para um aplicativo ClickOnce

  • Artigo

Os aplicativos ClickOnce podem ser associados a uma ou mais extensões de nome de arquivo, de modo que o aplicativo seja iniciado automaticamente quando o usuário abrir um arquivo desses tipos. É simples adicionar suporte à extensão de nome de arquivo a um aplicativo ClickOnce.

Observação

Para criar associações de arquivos em um aplicativo ClickOnce do .NET (em vez do .NET Framework), consulte Acessar os dados de ativação do ClickOnce para .NET no Windows.

Para criar associações de arquivos para um aplicativo ClickOnce

  1. Crie um aplicativo ClickOnce normalmente ou use o aplicativo ClickOnce existente.

  2. Abra o manifesto do aplicativo com um editor de texto ou XML, como o Bloco de Notas.

  3. Localize o elemento assembly. Para obter mais informações, confira Manifesto do aplicativo ClickOnce.

  4. Como filho do elemento assembly, adicione um elemento fileAssociation. O elemento fileAssociation tem quatro atributos:

    • extension: a extensão de nome de arquivo que você deseja associar ao aplicativo.

    • description: uma descrição do tipo de arquivo, que será exibida no shell do Windows.

    • progid: uma cadeia de caracteres que identifica exclusivamente o tipo de arquivo a fim de marcá-lo no Registro.

    • defaultIcon: um ícone a ser usado para esse tipo de arquivo. O ícone precisa ser adicionado como um recurso de arquivo ao manifesto do aplicativo. Para obter mais informações, consulte Como incluir um arquivo de dados em um aplicativo ClickOnce.

      Para obter um exemplo dos elementos file e fileAssociation, confira Elemento <fileAssociation>.

  5. Se você quiser associar mais de um tipo de arquivo ao aplicativo, adicione outros elementos fileAssociation. Observe que o atributo progid deve ser diferente para cada um.

  6. Depois de concluir o manifesto do aplicativo, assine novamente o manifesto. Você pode fazer isso na linha de comando usando Mage.exe.

    mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx

    Para obter mais informações, consulte Mage.exe (Manifest Generation and Editing Tool).

    Observação

    No ClickOnce para .NET Core 3.1 e .NET 5 ou posterior, use dotnet-mage.exe em vez de Mage.exe. Para obter mais informações, confira ClickOnce para .NET.

Conteúdo relacionado