Visor de Documentos para ASP.NET Core y .NET Standard
12/8/2023

Visor de Documentos para ASP.NET Core y .NET Standard

Qué entornos de ejecución apunta el visor Doconut, dónde se ejecuta, qué debe instalar el navegador y qué hace el servidor en su lugar. Hechos, no una página de ventas.

El visor que ejecuta este sitio es un componente nativo de .NET. En tu propio proyecto es una referencia, no un servicio al que llamas. Dos objetivos de compilación: .NET Framework 4.0 y superiores, y .NET Standard 2.0 y superiores, que es lo que lo coloca dentro de .NET Core y todo lo que viene después. El componente es Doconut.

ASP.NET CORE | .NET STANDARD VISOR DE DOCUMENTOS
ASP.NET CORE | .NET STANDARD VISOR DE DOCUMENTOS

En qué objetivo estás

Elige según lo que ya sea el proyecto, no según lo que suene más nuevo.

  • WebForms o MVC en .NET Framework — el objetivo 4.0+. No hay nada que cambiar.
  • ASP.NET Core MVC o Razor Pages — el objetivo .NET Standard 2.0.
  • Blazor Server — el mismo objetivo .NET Standard 2.0. El renderizado ocurre en el servidor de cualquier forma, por lo que el modelo de alojamiento no cambia lo que el componente necesita.
  • Contenedores Linux — compatible. Es la ruta .NET Core, en un contenedor.

Ambos objetivos usan el mismo motor de renderizado. El objetivo decide qué ensamblado referencias, no qué formatos obtienes.

Qué instala el navegador

Nada. No hay ActiveX, ni complemento, ni Java, ni lector. El servidor convierte el documento en algo que el navegador ya sabe dibujar y lo envía. Por eso el visor se comporta igual en un escritorio corporativo muy restringido que en un teléfono: no hay nada en el cliente que pueda faltar o estar desactualizado.

Qué hace el servidor en su lugar

Todo. El documento se abre, se dispone y se renderiza en tu máquina, lo que tiene dos consecuencias que vale la pena planificar.

  • No se necesita Office en el servidor. El motor de renderizado es .NET nativo y lee los formatos directamente. No hay instalación de Office, ni Interop, ni COM.
  • Renderizar consume CPU y memoria en tu equipo. Un PDF de 200 páginas y un dibujo CAD de 40 MB no son la misma solicitud. Dimensiona la máquina para el archivo más grande que realmente aceptarás y limita las cargas a ese tamaño.

Qué no es

No es una biblioteca JavaScript del lado del cliente que abre archivos en el navegador, y no es una API alojada a la que envías documentos. Si necesitas alguna de esas cosas, este no es el componente adecuado y es mejor saberlo desde el principio.

¿Quieres ver el resultado antes de referenciar nada? Es el mismo motor detrás del visor de este sitio — sube un archivo y eso es lo que obtendrían tus usuarios. Las licencias, paquetes y documentación de la API están en Doconut.com.