Sie haben einen selbstgehosteten, blitzschnellen Dokumentenbetrachter, der in Ihrer .NET‑Anwendung läuft
Am Ende dieser Anleitung können Sie PDFs, Office‑Dateien, CAD‑Zeichnungen und Dutzende weiterer Formate direkt im Browser öffnen, mit Ladezeiten von weniger als einer Sekunde, ohne externe SaaS‑Aufrufe und mit voller Kontrolle über die Sicherheit.
Voraussetzungen
| Was Sie benötigen | Warum es wichtig ist |
|---|---|
| .NET 6 oder höher (das SDK zielt auf .NET 6+) | Garantiert die Kompatibilität mit dem Online Document Viewer SDK |
| Ein Windows‑ oder Linux‑Server, auf dem Sie Ihre Anwendung ausführen können (vor Ort oder in einer privaten Cloud) | Selbst‑hosting erfordert, dass der Betrachter in Ihrer eigenen Infrastruktur betrieben wird |
| Zugriff auf den Online Document Viewer NuGet‑Feed (https://doconut.com) | Das SDK wird als NuGet‑Paket bereitgestellt |
| Grundkenntnisse in ASP.NET Core und Front‑End‑JavaScript | Sie stellen einen Endpunkt bereit, der eine signierte URL zurückgibt, und starten anschließend den Betrachter aus dem Browser |
| Ein Speicherort für die Quelldateien (Dateisystem, Blob‑Speicher usw.) | Der Betrachter rendert Dateien von einem lokalen oder Netzwerkpfad; die Quelle muss für den Serverprozess erreichbar sein |
Fehlt einer dieser Punkte, wird der Build gestoppt, bevor die erste Codezeile ausgeführt wird.
Installieren Sie das Online Document Viewer SDK
Öffnen Sie Ihre Lösung in Visual Studio oder Ihrer bevorzugten IDE und fügen Sie das offizielle SDK über den NuGet‑Manager hinzu:
dotnet add package Doconut.NET8
Das Paket enthält die Rendering‑Engine, Formatkonverter und eine schlanke HTTP‑Schicht, die die generierten Seiten bereitstellt. Da das SDK in Ihre Anwendung kompiliert wird, wird zur Laufzeit kein externer Dienst kontaktiert.
Nachdem das Paket wiederhergestellt wurde, registrieren Sie die SDK‑Dienste in Program.cs (oder Startup.cs für ältere Vorlagen). Die Registrierung injiziert die Rendering‑Pipeline in den ASP.NET‑Core‑DI‑Container und macht sie für Ihre Controller verfügbar.
Konfigurieren Sie die Rendering‑Pipeline für die erforderlichen Formate
Der Betrachter unterstützt von Haus aus mehr als 50 Formate, darunter:
- PDF, DOC, DOCX, ODT, RTF
- XLS, XLSX, CSV, ODS
- PPT, PPTX, ODP
- DWG, DXF, DGN (CAD)
- PSD, SVG, TIFF, WEBP, ICO
- EML, MSG, EPUB, MOBI, MPP, VSD
Wenn eine Anfrage eintrifft, ermittelt das SDK den Dateityp und wählt den passenden Konverter aus. Für optimale Leistung aktivieren Sie die integrierte Caching‑Schicht, die die gerenderte Seite für die Dauer der Anfrage im Speicher speichert; das ist es, was das „Blitzschnell – Sofortige Dokumenten‑Renderung mit optimierter Leistung und Unter‑Sekunden‑Ladezeit“-Erlebnis ermöglicht.
Rufen Sie in Ihrem Controller die Rendering‑Methode des SDKs (z. B. RenderAsync) auf und übergeben Sie den absoluten Pfad der Quelldatei. Die Methode gibt ein HTML‑Fragment zurück, das einen canvas‑basierten Betrachter enthält. Da das Rendering auf dem Server erfolgt, erhält der Client nur sofort anzeigbares Markup, was schwere clientseitige Verarbeitung eliminiert.
Sichern Sie den Betrachter mit tokenbasierten URLs und optionalen Einschränkungen
Datensouveränität und DSGVO‑Konformität sind häufige Bedenken bei Vor‑Ort‑Bereitstellungen. Das SDK integriert sich in das Authentifizierungssystem von ASP.NET Core und ermöglicht es Ihnen, ein signiertes Token zu erzeugen, das einmaligen Zugriff auf ein bestimmtes Dokument gewährt.
Typischer Ablauf:
- Das Front‑End fragt Ihre API nach einem Vorschau‑Token und übermittelt die Dokumenten‑Kennung.
- Ihre API prüft die Berechtigungen des Benutzers, erstellt ein JWT‑ähnliches Token, das den Dateipfad und einen Ablaufzeitstempel kodiert, und gibt das Token zurück.
- Das Front‑End hängt das Token an die Betrachter‑URL an (z. B.
/viewer?token=…). Das SDK validiert das Token bei jeder Anfrage und verwirft manipulierte oder abgelaufene Tokens.
Wenn Sie verhindern müssen, dass Benutzer das Dokument herunterladen oder drucken, konfigurieren Sie die vom SDK bereitgestellten Rendering‑Optionen, um diese Aktionen zu deaktivieren. Die JavaScript‑Ebene des Betrachters blendet dann die Download‑Schaltfläche aus, unterdrückt die Druck‑Kurzbefehle und blockiert das Kontextmenü bei Rechtsklick.
Überprüfen Sie, ob alles funktioniert
- Navigieren Sie zur Seite, die den Betrachter hostet.
- Das Dokument sollte innerhalb einer Sekunde erscheinen, mit Bildlaufleisten, Zoom‑Steuerungen und einem Suchfeld.
- Wenn Sie den Betrachter so konfiguriert haben, dass das Herunterladen deaktiviert ist, sollte die Schaltfläche „Download“ ausgeblendet sein.
- Rechtsklick auf das Dokument sollte das Browser‑Kontextmenü nicht öffnen, wenn diese Einschränkung aktiviert ist.
- Nach Ablauf des Tokens (Standard ist 5 Minuten) sollte das Aktualisieren der Seite einen „401 Unauthorized“-Fehler zurückgeben, was bestätigt, dass die Token‑Validierung aktiv ist.
Falls einer dieser Tests fehlschlägt, gehen Sie den entsprechenden Schritt erneut durch: fehlende SDK‑Registrierung, falsche Token‑Erstellung oder ausgelassene Sicherheits‑Flags.