Como criar uma caixa de diálogo Download de Arquivos para um tipo MIME conhecido

Este artigo fornece as informações sobre como criar uma caixa de diálogo Download de Arquivos para tipos MIME conhecidos no Microsoft Edge e na Internet Explorer.

Versão original do produto: Internet Explorer 11, Internet Explorer 10, Internet Explorer 8, Internet Explorer 7, Microsoft Edge
Número de KB original: 260519

Resumo

Ao servir um documento de um servidor Web, talvez você queira solicitar imediatamente que o usuário salve o arquivo diretamente no disco do usuário, sem abri-lo no navegador. No entanto, para tipos mime conhecidos (Extensões multiuso do Internet Mail), como o Microsoft Word (aplicativo/ms-word), o comportamento padrão é abrir o documento na Internet Explorer.

Você pode usar o cabeçalho de disposição de conteúdo para substituir esse comportamento padrão. Seu formato é:

Content-disposition: attachment; filename=fname.ext

Mais informações

Content-disposition é uma extensão do protocolo MIME que instrui um agente de usuário MIME sobre como ele deve exibir um arquivo anexado. O intervalo de valores válidos para content-disposition são discutidos em Solicitação de Comentário (RFC) 1806 (consulte a seção Referências deste artigo). Este artigo se concentra no argumento de anexo, que instrui um agente de usuário (nesse caso, o Internet Explorer) a salvar um arquivo em disco em vez de salvá-lo embutido.

Quando o Explorer da Internet recebe o cabeçalho, ele levanta uma caixa de diálogo Download de Arquivo cuja caixa de nome de arquivo é preenchida automaticamente com o nome do arquivo especificado no cabeçalho. Observe que isso é por design; não há como usar esse recurso para salvar um documento no computador do usuário sem solicitar um local de salvamento.

Há duas maneiras de usar a Internet Explorer para especificar um content-disposition cabeçalho para um arquivo: dinamicamente e estaticamente.

Para aplicar o cabeçalho dinamicamente, crie um arquivo ASP (Active Server Pages) que grava o documento no navegador. Use o Response.AddHeader método para adicionar o content-disposition cabeçalho. Por exemplo:

Response.AddHeader "content-disposition","attachment; filename=fname.ext"

Essa técnica é ideal quando você deseja proteger um repositório de documentos em seu servidor, especialmente um que existe fora da raiz da Web.

Para aplicar o cabeçalho estaticamente, clique com o botão direito do mouse no documento no Service Manager da Internet e selecione Propriedades. Selecione a guia Cabeçalho HTTP e insira o content-disposition cabeçalho lá. Isso funciona melhor quando você só deseja aplicar content-disposition a alguns arquivos em seu sistema e não requer a sobrecarga do ASP.

Referências

Para obter mais informações sobre content-disposition, consulte Solicitação de Comentários (RFC) 1806.