Konfiguracja w .NET 6 lub wyższym

Plik Startup.cs

W pliku Startup.cs projektu .NET Core te linie kodu definiują konfigurację potoku middleware przy użyciu metody MapWhen. Podany predykat sprawdza, czy ścieżka przychodzącego żądania kończy się na DocImage.axd. Wewnątrz tego bloku wywoływana jest metoda UseDoconut z obiektem DoconutOptions jako argumentem.

app.MapWhen(
    context => context.Request.Path.ToString().EndsWith("DocImage.axd"),
    appBranch =>
    {
        appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });
    }
);

Dodaj przestrzenie nazw Doconut

W swoim projekcie dodaj następujące instrukcje using:

using Doconut;
using Doconut.Configs;
using Doconut.Formats;
using Doconut.Clouds;

Utwórz obiekt Viewer

Ta linia tworzy nową instancję klasy Viewer, umożliwiając stworzenie obiektu Viewer w Twoim kodzie.

var docViewer = new Viewer(_cache, _accessor, licenseFilePath);

Utwórz obiekt DocOptions

Przykładowa inicjalizacja obiektu DocOptions z konkretnymi konfiguracjami:

var documentOptions = new DocOptions
{
    Password = "",
    ImageResolution = 200,
    TimeOut = 30
};

Utwórz obiekt konfiguracyjny

Zainicjalizuj nowy obiekt PdfConfig z określonymi konfiguracjami do obsługi dokumentów PDF:

var config = new PdfConfig { DefaultRender = true, ExtractHyperlinks = true };

Otwórz swój dokument

Ten wiersz wywołuje metodę OpenDocument obiektu przeglądarki, przekazując ścieżkę do pliku dokumentu znajdującego się na serwerze oraz wcześniej skonfigurowane obiekty PdfConfig i DocOptions jako parametry.

var token = docViewer.OpenDocument(pathToFile, config, documentOptions);

Dodaj przeglądarkę w swoim HTML

<div id="div_ctlDoc"></div>

Dodaj pliki CSS i JavaScript

Dodaj następujące pliki CSS i JavaScript na stronie. Skrypty te są zawarte w pliku ZIP z przykładami kodu.

<!-- Main Viewer Related Scripts -->
<script src="scripts/splitter.js"></script>
<script src="scripts/docViewer.js"></script>
<script src="scripts/documentLinks.js"></script>

<!-- Viewer functions -->
<script src="scripts/docViewer.UI.js?v=1"></script>

Wymagane pakiety NuGet

Aby zapewnić pełną kompatybilność Twojego projektu z .NET Core Standard, należy uwzględnić następujące pakiety NuGet, wymienione w kolejności alfabetycznej.

• MessagePack - Wersja 2.5.140
• Microsoft.Bcl.AsyncInterfaces - Wersja 8.0.0
• Microsoft.Extensions.Caching.Abstractions - Wersja 8.0.0
• Microsoft.Extensions.Configuration - Wersja 8.0.0
• Microsoft.Extensions.Configuration.Abstractions - Wersja 8.0.0
• Microsoft.Extensions.Configuration.FileExtensions - Wersja 8.0.0
• Microsoft.Extensions.Configuration.Json - Wersja 8.0.0
• Microsoft.Extensions.FileProviders.Abstractions - Wersja 8.0.0
• Microsoft.Extensions.FileProviders.Physical - Wersja 8.0.0
• Microsoft.Extensions.FileSystemGlobbing - Wersja 8.0.0
• Microsoft.Extensions.Primitives - Wersja 8.0.0
• System.Buffers - Wersja 4.5.1
• System.Formats.Asn1 - Wersja 8.0.0
• System.Numerics.Vectors - Wersja 4.5.0
• System.Security.Cryptography.Cng - Wersja 5.0.0
• System.Security.Cryptography.Pkcs - Wersja 8.0.0
• System.Text.Encoding.CodePages - Wersja 8.0.0
• System.Text.Encodings.Web - Wersja 8.0.0
• System.Text.Json - Wersja 8.0.3
• System.Threading.Tasks.Extensions - Wersja 4.5.4

Opcje konfiguracji renderowania

Możesz skonfigurować zachowanie renderowania, używając następujących opcji:

• CadConfig: Używany dla plików DWG, DXF i DGN.
• EmailConfig: Używany dla plików EML, EMLX i MSG.
• EpubConfig: Używany dla plików EPUB.
• ExcelConfig: Używany dla plików Excel i CSV.
• MhtConfig: Używany dla plików MHT.
• PptConfig: Używany dla plików PowerPoint.
• ProjectConfig: Używany dla plików MPP.
• PsdConfig: Używany dla plików PSD.
• TxtConfig: Używany dla plików TXT.
• TiffConfig: Używany dla plików TIFF.

Konfiguracja Opcji Renderowania

Opcje renderowania są konfigurowane przy użyciu właściwości DefaultRender:

• DefaultRender = true : Ta opcja oferuje renderowanie wyższej jakości, ale zużywa więcej pamięci serwera i czasu przetwarzania.
• DefaultRender = false : Ta opcja zapewnia szybsze renderowanie kosztem nieco obniżonej jakości.

Niestandardowe czcionki w dokumentach Word

Właściwość FontFolders w klasie WordConfig określa niestandardowe katalogi, w których aplikacja będzie wyszukiwać czcionki. Jest to szczególnie przydatne przy przetwarzaniu dokumentów Word, które polegają na czcionkach niezainstalowanych w domyślnych katalogach czcionek systemu.

var config = new WordConfig
{
    FontFolders = new string[] { "C:\\CustomFonts", "D:\\SharedFonts" }
};

Ważna aktualizacja dla Doconut 25.2.0

Niezbędne jest zaktualizowanie pakietu System.Text.Json do wersji 8.0.5 we wszystkich twoich projektach. Ta aktualizacja jest kluczowa, aby zapewnić kompatybilność z najnowszymi funkcjami oraz rozwiązać ważne ulepszenia bezpieczeństwa.

Kodowanie e-maila

Właściwość EmailEncoding w klasie EmailConfig określa preferowane kodowanie zarówno tematu, jak i treści wiadomości e-mail.

var emailConfig = new EmailConfig {
    EmailEncoding = Encoding.UTF8 // Set preferred email encoding
};

Kodowanie tematu i treści

Właściwości SubjectEncoding i BodyEncoding w klasie EmailConfig definiują kodowanie używane dla tematu i treści wiadomości e-mail, odpowiednio.

var emailConfig = new EmailConfig {
    SubjectEncoding = Encoding.UTF8, // Set encoding for the subject
    BodyEncoding = Encoding.UTF8     // Set encoding for the body
};

Obsługa kultury w przeglądarce Word

Właściwość DocumentCulture w klasie WordConfig pozwala wyraźnie określić kulturę dla plików DOC i DOCX. Zapewnia to, że treści lokalizowane — takie jak daty, waluty i liczby — są wyświetlane dokładnie tak, jak w programie Microsoft Word. Jest to szczególnie przydatne dla języków z określonymi wymaganiami formatowania.

var config = new WordConfig { DocumentCulture = "he-IL" }; // Hebrew (Israel)
var config = new WordConfig { DocumentCulture = "ar-SA" }; // Arabic (Saudi Arabia)
var config = new WordConfig { DocumentCulture = "th-TH" }; // Thai (Thailand)
var config = new WordConfig { DocumentCulture = "ja-JP" }; // Japanese (Japan)