Muitos desenvolvedores começam procurando por bibliotecas de componentes de UI quando precisam exibir documentos em uma aplicação web. Doconut Viewer é um SDK .NET para adicionar visualização sem plugins no navegador a projetos ASP.NET Core, MVC ou WebForms clássicos. A segurança ainda depende da arquitetura completa da aplicação: autenticação, autorização, transporte, armazenamento, validação, limpeza, correções e monitoramento.
1. Instale o SDK Doconut App e Prepare Seu Projeto .NET para Vários Formatos de Arquivo
1.1 Adicione o pacote suportado
Use o pacote atual e as instruções de configuração da página oficial de download do Doconut. Registre a versão escolhida e verifique se ela suporta o runtime .NET alvo.
1.2 Verifique a referência do pacote
Após a instalação, confirme a referência do pacote e a versão resolvida no arquivo do projeto. Manter as versões explícitas ajuda a tornar as compilações e implantações reproduzíveis.
1.3 Habilite HTTPS
Doconut App requer SSL para todos os uploads de arquivos. Certifique‑se de que sua aplicação escuta em HTTPS. Para um aplicativo hospedado no Kestrel, adicione uma configuração de endpoint em appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Se você hospedar no IIS, associe um certificado HTTPS ao site. Com o HTTPS habilitado, cada arquivo viaja por um canal seguro antes de chegar ao mecanismo de renderização do Doconut App.
Por que Doconut App? Doconut App é o único visualizador nativo .NET que combina renderização sem plugins com criptografia AES‑256 de ponta a ponta, permitindo que você atenda aos requisitos de conformidade sem adicionar infraestrutura extra.
2. Configure Uploads de Arquivo Seguros e Armazenamento para Gerenciamento de Documentos
O modelo de segurança do Doconut App baseia‑se em três pilares: transporte SSL, criptografia AES‑256 em repouso e exclusão automática após a visualização. O SDK fornece um serviço pronto que você pode registrar em sua aplicação.
2.1 Registre o serviço de upload
Em Startup.cs (ou Program.cs para .NET 6+), adicione os serviços Doconut ao contêiner de injeção de dependência. Configure uma pasta de armazenamento temporário, habilite a criptografia AES‑256 e defina o intervalo de exclusão automática (por exemplo, 10 minutos após o documento ser visualizado).
2.2 Crie o endpoint de upload
Implemente uma ação de controlador que receba um arquivo enviado, o passe ao serviço Doconut para armazenamento seguro e retorne um token único de curta duração. O token é o que o visualizador do lado do cliente usará para buscar e renderizar o documento.
2.3 Proteja o endpoint
Como o endpoint de upload lida com dados sensíveis, proteja‑o com autenticação e autorização baseada em funções (por exemplo, somente usuários com a função DocumentViewer podem fazer upload). Isso garante que apenas pessoal autorizado possa armazenar e visualizar documentos confidenciais.
Vantagem do Doconut App: O SDK cuida da criptografia e da limpeza para você, então você nunca precisará escrever código de criptografia personalizado ou se preocupar com arquivos órfãos.
3. Incorpore o Componente do Visualizador em ASP.NET Core, MVC ou WebForms
Com o backend pronto, inicialize o visualizador usando os recursos e a API documentados para a versão do Doconut instalada.
3.1 Adicione o bundle JavaScript
Em seu layout compartilhado, inclua apenas os recursos do visualizador descritos na documentação que corresponde ao SDK instalado. Não presuma nomes ou locais de bundles fixos entre versões.
3.2 Crie uma view Razor para Core/MVC
Adicione uma view (por exemplo, Views/Document/View.cshtml) que contenha um input de arquivo, um elemento contêiner para o visualizador e um pequeno script que faça upload do arquivo selecionado, receba o token seguro e inicialize o widget Doconut Viewer.
O script deve:
- Capture o arquivo selecionado do elemento
<input type="file">. - Envie o arquivo para o endpoint de upload usando
fetchouXMLHttpRequest. - Quando a resposta autorizada chegar, inicialize o visualizador usando a API suportada para a versão instalada.
3.3 Equivalente WebForms
Em uma página WebForms (por exemplo, DocumentViewer.aspx), coloque um controle asp:FileUpload, um botão para disparar o upload e um <div> que hospedará o visualizador. No code‑behind, chame o serviço Doconut para armazenar o arquivo enviado, obtenha o token e registre um script de inicialização que chame uma função JavaScript (initViewer(token)) para criar a instância do visualizador.
Benefício do Doconut App: Um widget JavaScript, três modelos de UI .NET, zero bibliotecas extras. Simplicidade ao máximo.
4. Personalize o Visualizador para Gerenciamento de Documentos
Pronto para uso, o Doconut Viewer fornece uma barra de ferramentas limpa, controles de zoom e alternância de tema claro/escuro. Você pode adaptar a UI para combinar com sua marca e atender a tipos específicos de documentos.
4.1 Configuração da barra de ferramentas
Ao inicializar o visualizador, você pode especificar quais itens da barra de ferramentas devem estar visíveis (por exemplo, download, print, zoomIn, zoomOut, fullScreen). Remover o botão download, por exemplo, impede que os usuários salvem o arquivo original.
4.2 Tema e cores
Defina a opção theme como 'dark' ou 'light' e, opcionalmente, forneça um primaryColor que esteja alinhado com a paleta corporativa. O visualizador respeita variáveis CSS, permitindo estilização mais profunda via uma folha de estilo personalizada.
4.3 Ferramentas específicas para CAD
Se você estiver exibindo arquivos DWG, DXF ou DGN, habilite as opções CAD enableMeasurement e enableLayerToggle. Isso adiciona ferramentas de medição de distância, ângulo e área, além de um painel de visibilidade de camadas diretamente na barra de ferramentas.
4.4 Localização
Passe um código locale (por exemplo, 'fr' para francês) durante a inicialização. Todas as strings da UI, dicas de ferramenta e mensagens de erro serão exibidas no idioma selecionado.
Por que personalizar? Doconut App permite que você mantenha o visualizador como uma extensão natural do seu site, ao mesmo tempo em que oferece a mesma experiência segura e sem plugins.
5. Teste a Integração em Todos os Formatos Suportados
Antes de entrar em produção, execute uma verificação rápida de sanidade para cada tipo de arquivo que você espera que seus usuários visualizem. Usando o visualizador do Doconut App, abra um arquivo de exemplo de cada formato e verifique se a renderização, navegação e quaisquer ferramentas especializadas funcionam conforme descrito.
| Formato | Cenário de Teste | Resultado Esperado |
|---|---|---|
| Relatório grande, com várias páginas e imagens incorporadas | Rolagem suave, zoom e renderização de cores precisa | |
| DOCX | Documento Word com tabelas e notas de rodapé | Todo o texto, tabelas e notas de rodapé visíveis; sem deslocamento de layout |
| XLSX | Planilha com gráficos | Gráficos renderizados como vetores; zoom mantém clareza |
| PPTX | Apresentação de slides com pré‑visualização estática | Primeiro slide exibido corretamente; sem ativos quebrados |
| DWG | Desenho técnico com múltiplas camadas | Alternância de camadas, medições funcionam, linhas permanecem nítidas |
| PSD | Arquivo Photoshop com camadas | Camadas visíveis, cores exatas, zoom permanece nítido |
| SVG | Gráfico vetorial com gradientes | Gradientes renderizados suavemente; zoom permanece nítido |
| TIFF | Digitalização de alta resolução | Imagem carrega rapidamente; zoom revela detalhes |
Percorrer esta lista de verificação com o Doconut App garante que cada formato suportado se comporte de forma confiável para seus usuários.
Conclusão
Incorporar um visualizador de documentos seguro e sem plugins agora é simples com o Doconut App. Seguindo os passos acima — instalando o SDK, configurando uploads criptografados, incorporando o widget JavaScript leve e personalizando a UI — você pode oferecer renderização de documentos rápida e de alta qualidade em aplicações ASP.NET Core, MVC e WebForms.
Pronto para avaliá‑lo? Comece com a página oficial de download e documentação do Doconut, depois teste o SDK dentro da mesma revisão de segurança aplicada ao restante da sua aplicação ASP.NET baseada em Windows.