Konfiguracja w .NET Standard / Core

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 żą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 utworzenie obiektu Viewer w Twoim kodzie.

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

Skonfiguruj obiekt DocOptions

Przykładowa inicjalizacja obiektu DocOptions z określonymi 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 dokument

Ta linia 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 podgląd 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ą dołączone w pliku ZIP z przykładami kodu.

<link rel="stylesheet" href="css/viewer.css" />

<!-- Main Viewer Related Scripts -->
<script src="scripts/jquery.min.js"></script>
<script src="scripts/docViewer.js"></script>
<script src="scripts/splitter.js"></script>
<script src="scripts/search.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ą zgodność 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 do plików DWG, DXF i DGN.
• EmailConfig: używany do plików EML, EMLX i MSG.
• EpubConfig: używany do plików EPUB.
• ExcelConfig: używany do plików Excel i CSV.
• MhtConfig: używany do plików MHT.
• PptConfig: używany do plików PowerPoint.
• ProjectConfig: używany do plików MPP.
• PsdConfig: używany do plików PSD.
• TxtConfig: używany do plików TXT.
• TiffConfig: używany do 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 projektach. Ta aktualizacja jest kluczowa, aby zapewnić kompatybilność z najnowszymi funkcjami oraz rozwiązać ważne poprawki 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 określają 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 w przypadku języków wymagających określonych formatów.

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)