Performance-Optimierung
Rendern und Speicher optimieren
Das Ressourcenprofil von Doconut wird von drei Dingen dominiert: Render-DPI, was im Cache bleibt und wie lange Sitzungen leben. Dieser Leitfaden führt die Stellschrauben in Reihenfolge ihrer Wirkung auf.
Auflösung — die größte Stellschraube
ImageResolution (25–300 DPI) bestimmt sowohl die Renderzeit als auch die Bildgröße. Die meisten Formate haben standardmäßig 200 DPI; Bilder und PSD haben standardmäßig 100.
// Eine Dokumentenlisten-Vorschau benötigt keine Druckqualität
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Eine Halbierung des DPI reduziert ungefähr um das Vierfache die Pixelanzahl pro Seite — schnellere Renderings, kleinere Übertragungen, weniger Cache‑Speicher. Reservieren Sie 250–300 DPI für stark zoomende Anwendungsfälle (CAD, technische Zeichnungen).
Für PDFs mit umfangreichen eingebetteten Bildern fügt PdfConfig feinere Stellschrauben hinzu: CompressImages + CompressQuality, ResizeImages + ResizeResolution und CompressFast. Für reine Bilder begrenzt ImageConfig.MaxImagePixelSize (Standard 3000 px) die Ausgabengröße.
Seiten‑Caching — Speicher vs. Neu‑Rendern
BaseConfig.CachePages (Standard true) hält jede gerenderte Seite im Speicher für die gesamte Sitzungsdauer. Das ist die richtige Standardeinstellung für interaktives Betrachten — Benutzer scrollen vor und zurück. Deaktivieren Sie es, wenn:
- Dokumente sind riesig und werden einmalig von vorne bis hinten betrachtet,
- Viele gleichzeitige Sitzungen würden die zwischengespeicherten Seiten vervielfachen,
- Sie lieber CPU pro Ansicht bezahlen möchten, anstatt RAM zu belegen.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });Auf dem Client lädt ViewerConfig.CacheEnabled = true ein kleines, sich bewegendes Fenster der kommenden Seitenbilder im Browser‑Speicher vor. Es ist ein per‑Ansicht Vorabruf‑Cache, kein permanenter localStorage.
Sitzungen — der Speicher, den Sie nicht sehen
Jede offene Sitzung hält das geparste Dokumentenmodell plus (mit CachePages) seine gerenderten Seiten, bis das gleitende TimeOut (Standard 60 Minuten) seit der letzten Anforderung abläuft. Zwei Gewohnheiten halten dies unter Kontrolle:
- Schließen Sie, was Sie nicht mehr benötigen.
viewer.CloseDocument(token)gibt die Engine sofort frei, anstatt das Leerlauffenster abzuwarten. - Passen Sie die Timeout‑Dauer an. Eine Vorschau, die Benutzer für zwei Minuten betrachten, benötigt keine einstündige Sitzung:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Beachten Sie den Kompromiss: Nach Ablauf zeigt das Widget Document session not found. Please re-open document. — wählen Sie ein Timeout, das zu echten Lesesitzungen passt.
Format‑spezifische Schalter
- Excel:
MemoryOptimizationPreferenceist standardmäßig aktiviert und reduziert den Speicherverbrauch beim Rendern sehr großer Arbeitsmappen — lassen Sie es aktiviert, oder setzen Sie es auffalse, wenn Sie Speicher für einen kleinen Geschwindigkeitsgewinn tauschen möchten;SheetNames/PrintAreabeschränken das Rendern auf das Wesentliche. - Redirect‑Modus hat eine Vorabkosten:
DefaultRender = falsekonvertiert das gesamte Dokument beim Öffnen in PDF. Das ermöglicht native textbasierte Suche, aber bei einem 500‑Seiten‑Dokument trägt der Öffnungsaufruf diese Konvertierung — aktivieren Sie es nicht reflexartig. - Word/PowerPoint auf einem Server ohne die Dokumentenschriften: Ein Windows‑Server ohne Office hat deutlich weniger Schriftarten als ein Entwicklungsrechner. Fehlende Schriften führen zu langsamen Fallback‑Abfragen und falschen Metriken; installieren Sie die Schriften oder verweisen Sie
FontFoldersauf einen Ordner, der sie enthält.
Client‑seitige Strategien
LargeDoc = true— Lazy‑Load‑Strategie für sehr große Dokumente; Seiten werden geladen, wenn der Benutzer sich ihnen nähert.AutoLoad = false(Standard) — nicht rendern, bis Sie tatsächlichView(token)aufrufen.ShowThumbs = false— Thumbnail‑Erstellung/-Anfragen für einseitige oder eingebettete Vorschauen überspringen.- Das Aktivieren von
FixedZoomverhindert freie Zoom‑Änderungen; wenn Sie ein C#ViewerConfigzuordnen, stellen SieFixedZoomPercentMobile(C#‑Standard 75) für kleine Bildschirme ein.
Einmaliger Start, nicht pro Anfrage
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) gehört zu Program.cs — das Registrieren von Codierungen pro Anfrage ist unnötige Arbeit; das vollständige Vergessen davon bricht Legacy‑Code‑Page‑Dokumente.
Verteilung der Arbeit über Knoten
Alles oben stellt das Rendering eines einzelnen Knotens bei Bedarf ein. Wenn ein einzelner Knoten die Last nicht bewältigen kann, ist die nächste Stellschraube kein größerer Drehregler — sondern das Veröffentlichen der Dokumentartefakte einmalig in gemeinsamen Speicher und das Bereitstellen durch jeden Knoten. Das ändert das Kostenmodell: Rendering erfolgt einmal pro Dokument statt einmal pro Sitzung, und Seitenanfragen werden zu Dateilesungen. Siehe Verteilte Bereitstellungen.
Eine Optimierungs‑Checkliste
- Setzen Sie das niedrigste
ImageResolution, das Ihre UX akzeptiert. - Lassen Sie
CachePagesfür interaktives Betrachten aktiviert; deaktivieren Sie es für Einmal‑Durchläufe oder Szenarien mit hoher Parallelität. - Schließen Sie Sitzungen explizit; verkürzen Sie
TimeOut, wenn die Nutzung burstartig ist. - Verwenden Sie
LargeDoc+ Standard-AutoLoad = falseauf dem Client für große Dokumente. - Verwenden Sie
DefaultRender = falsenur, wenn Sie eine textbasierte PDF‑Projektion benötigen.
War diese Seite hilfreich?