.ASHX

Arquivo ASHX

ASP.NET Generic HTTP Handler
Fazer uma pergunta
RESPOSTA RÁPIDA

Um arquivo ASHX é um manipulador HTTP genérico do ASP.NET - código do lado do servidor que é executado em um servidor web Microsoft IIS e retorna uma saída bruta, como uma imagem, um PDF ou um download de arquivo. Ele não deve ser aberto no seu computador. Se um site baixou um arquivo chamado algo.ashx quando você esperava um PDF ou imagem, renomeie-o para a extensão correta (.pdf, .jpg, .png, .zip) e abra-o normalmente.

Desenvolvedor: Microsoft Categoria: Arquivos de Internet MIME: text/html
ABRE EM Windows macOS Linux
Relacionado: .CRDOWNLOAD · .JNLP · .WEBARCHIVE · .PART

Nesta página

19k+ extensões indexadas
Última revisão em Sep 9, 2026

Não tem certeza do que é seu arquivo?

Arraste qualquer arquivo para o nosso identificador - lemos apenas os primeiros bytes para nomear o formato.

Identificar um arquivo

O que é o formato de ficheiro ASHX?

A extensão .ashx identifica um Manipulador HTTP Genérico do ASP.NET - um componente do lado do servidor desenvolvido pela Microsoft. Ao contrário de uma página ASP.NET padrão, um manipulador .ashx processa solicitações HTTP diretamente e transmite uma resposta (dados binários, JSON, imagens ou arquivos) sem a sobrecarga total de renderização de página de uma página .aspx comum.

Um arquivo de origem .ashx genuíno é texto simples. Ele começa com uma linha de diretiva como <%@ WebHandler Language="C#" Class="MyHandler" %>, seguida por uma classe que implementa a interface IHttpHandler. O código interno é escrito em C# ou VB.NET; o volume costuma ser relativamente pequeno, já que os manipuladores são construídos especificamente para uma única tarefa.

Arquivos .ashx podem aparecer inesperadamente ao tentar baixar um arquivo de um site. Isso ocorre quando um manipulador que serve o arquivo - uma imagem, um documento PDF ou outro recurso - não define o cabeçalho Content-Disposition correto, fazendo com que o navegador salve a resposta com um sufixo .ashx em vez da extensão pretendida.

Para recuperar tal arquivo, você pode usar um truque simples: renomeie-o alterando .ashx para a extensão correta (por exemplo, .pdf para um documento PDF, ou .jpg para uma imagem) e, em seguida, tente abri-lo com qualquer aplicativo que suporte esse formato. O mesmo método se aplica a outros tipos de arquivo - basta alterar a extensão para a adequada e abrir o arquivo com um programa que suporte o formato fornecido.

Segurança e proteção

RISCO: LOW

A extensão .ashx por si só não diz nada sobre segurança - em uma URL, é apenas um endpoint de um site normal; trate o site como faria com qualquer outro (cuidado com phishing em páginas de login). Um download que chegou como .ashx é normalmente o arquivo real (PDF, imagem) com o nome errado e é seguro renomear e abrir. Tenha cautela apenas com downloads .ashx inesperados de fontes não confiáveis - inspecione-os como texto ou por seu tipo real antes de abrir, e nunca execute nada que eles tentem iniciar.

Detalhes do formato

em resumo
NOME COMPLETOASP.NET Generic HTTP Handler
DESENVOLVEDORMicrosoftdesde 2002 (ASP.NET 1.0, .NET Framework)
TIPO MIMEtext/html
TIPOCódigo-fonte do manipulador ASP.NET do lado do servidor (texto: diretiva + C#/VB.NET); também aparece como um sufixo de URL, não um documento para download

Programas que abrem arquivos ASHX

Windows4 apps
Visual Studio Freemium Para desenvolvedores: abra o projeto ASP.NET para editar/executar o código-fonte do manipulador .ashx. O IDE padrão.
Notepad Código aberto Abra para inspecionar o código-fonte bruto do manipulador como texto - todo arquivo .ashx é texto simples.
Visual Studio Code Gratuito Abra o .ashx como texto para ler ou editar sua diretiva e código C#/VB. Gratuito e multiplataforma.
Web browser (Chrome, Edge, Firefox) Gratuito Útil apenas se um download foi nomeado incorretamente - mas geralmente você desejará renomeá-lo para o tipo real primeiro. Um navegador NÃO executará o manipulador do lado do servidor.
macOS2 apps
TextMate Código aberto Abra o .ashx como um arquivo de origem de texto simples para inspecioná-lo.
Visual Studio Code Gratuito Abra o .ashx como texto para ler ou editar sua diretiva e código C#/VB. Gratuito e multiplataforma.
Linux2 apps
Visual Studio Code Gratuito Abra o .ashx como texto para ler ou editar sua diretiva e código C#/VB. Gratuito e multiplataforma.
gedit / any text editor Código aberto Abra diretamente - o código-fonte do manipulador é texto simples.

Detalhes técnicos

especificação profunda
DesenvolvedorMicrosoft
PlataformaASP.NET (.NET Framework; também suportado no modo de compatibilidade inicial do ASP.NET Core)
Conteúdo do arquivoTexto simples; abre com uma diretiva `<%@ WebHandler %>` seguida por um corpo de classe C# ou VB.NET
Interface implementada`IHttpHandler` (síncrona) ou `IHttpAsyncHandler` (operações assíncronas)
Sintaxe da diretiva`%@ WebHandler Language="C#" Class="ClassName" %>`
Linguagens suportadasC# e VB.NET
Tipo MIME padrão`text/html`; o manipulador substitui isso definindo `context.Response.ContentType` antes de gravar a saída
Padrão de acesso à URLInvocado diretamente como um endpoint de URL (ex: `download.ashx?id=1`); não é uma página de navegador renderizada
Registro no servidorMapeado no `web.config` ou mapeamentos de manipulador do IIS; o tempo de execução do ASP.NET roteia solicitações correspondentes para a classe do manipulador
Assinatura bináriaNenhuma - arquivo de texto simples sem magic bytes; arquivos de origem são identificáveis apenas pela linha de diretiva de abertura
Estado da sessãoDesabilitado por padrão; habilitado ao implementar `IRequiresSessionState` na classe do manipulador
Usos comunsDownloads de arquivos, geração dinâmica de imagens, endpoints AJAX/JSON, streaming de dados binários ou de texto
Substituto modernoMiddleware do ASP.NET Core, Minimal APIs e extensões `IEndpointRouteBuilder` substituem o `.ashx` no .NET 5 e versões posteriores
Comportamento de artefato de downloadOs navegadores salvam `.ashx` como o sufixo do arquivo quando um manipulador omite `Content-Disposition`; renomear para a extensão real (`.pdf`, `.jpg`, etc.) recupera o arquivo
Lançado2002 (ASP.NET 1.0, .NET Framework)
Especificaçãolearn.microsoft.com

Conversões de ASHX

Perguntas e Respostas da Comunidade

perguntado por usuários
Faça uma pergunta rápida
Obtenha ajuda de pessoas que trabalham com arquivos ASHX. Seja específico - inclua seu sistema e a versão do software.
Não é necessário criar conta · respostas geralmente em um dia

Ainda não há perguntas - seja o primeiro a perguntar sobre arquivos ASHX.

Perguntas frequentes

O que é um arquivo .ashx?
É um manipulador HTTP genérico do ASP.NET - código do lado do servidor em um servidor web Microsoft IIS que retorna uma saída bruta (uma imagem, PDF, download ou dados) para o seu navegador. Não é um documento que você abre; ele é executado no servidor.
Por que um site baixou um arquivo .ashx em vez de um PDF ou imagem?
O manipulador gerou seu arquivo, mas o servidor o enviou com o nome .ashx. O download geralmente é o arquivo real - renomeie-o de .ashx para o tipo esperado (.pdf, .jpg, .png, .zip) e abra-o. Se isso falhar, clique com o botão direito no link e selecione «Salvar link como».
Como faço para abrir um arquivo .ashx?
Se for um download com nome incorreto, renomeie-o para o tipo real (.pdf/.jpg/.xlsx). Se você for um desenvolvedor trabalhando no código-fonte, abra-o no Visual Studio ou VS Code. Não existe um aplicativo que «execute» um .ashx fora de um servidor web.
O que significa .ashx em um endereço web?
Significa que a URL aponta para um manipulador HTTP do ASP.NET - normalmente usado para servir uma imagem dinâmica, download de arquivo ou dados. O servidor executa o manipulador e envia o resultado de volta.
Posso converter um .ashx para PDF?
Não com um conversor. Se um .ashx chegou onde deveria estar um PDF, ele quase certamente É o PDF com a extensão errada - renomeie-o para .pdf. Um .ashx genuíno é um código de servidor sem nada para converter.
Um arquivo .ashx é seguro?
Geralmente sim - como uma URL, é apenas um endpoint da web e, como download, geralmente é um arquivo real com nome incorreto. Abra downloads .ashx inesperados como seu tipo real e tenha cuidado apenas com fontes não confiáveis.

Referências

1Microsoft Learn - HTTP Handlers (IHttpHandler / .ashx)learn.microsoft.com
2Microsoft Learn - Walkthrough: creating a synchronous HTTP handlerlearn.microsoft.com

Continue explorando

em todo o banco de dados

Principais extensões desta semana

1.AQQAQQ Instant Messenger File
2.CRDOWNLOADChrome Partial Download File
3.PARTPartial Download File
4.DATProgram Data File (generic)
5.EXEWindows Executable (Portable Executable)
6.BINCD/DVD Disc Image (BIN/CUE)
7.RPMSGRestricted Permission Message
8.NOMEDIAAndroid No-Media Marker File
9.TXTPlain Text File
10.MDMarkdown Document

Extensões relacionadas

.CRDOWNLOADChrome Partial Download File
.JNLPJava Network Launch Protocol file
.WEBARCHIVESafari Web Archive
.PARTPartial Download File
.DOWNLOADPartial / Incomplete Download File
.ASPXActive Server Page Extended (ASP.NET Web Form)

Ferramentas de arquivo gratuitas

Um identificador de arquivos e conversor de imagens no navegador - tudo funciona no seu dispositivo.

Abrir a caixa de ferramentas

Navegar por extensões de arquivo A-Z