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, pozwalając na stworzenie obiektu widoku w kodzie.

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

Skonfiguruj obiekt DocOptions

Przykładowa inicjalizacja obiektu DocOptions ze specyficznymi ustawieniami:

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

Skonfiguruj obiekt config

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

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

Otwórz swój dokument

Ta linia wywołuje metodę OpenDocument obiektu viewer, 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 viewer 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.

<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ą kompatybilność projektu z .NET Core Standard, należy uwzględnić następujące pakiety NuGet, wymienione w kolejności alfabetycznej.

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

Opcje konfiguracji renderowania

Możesz skonfigurować zachowanie renderowania przy użyciu 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 konfiguruje się przy użyciu właściwości DefaultRender:

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

Niestandardowe czcionki w dokumentach Word

Właściwość FontFolders w klasie WordConfig określa niestandardowe katalogi, w których aplikacja będzie szukać czcionek. Jest to szczególnie przydatne przy przetwarzaniu dokumentów Word, które korzystają z czcionek 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

Konieczne 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ć istotne poprawki bezpieczeństwa.

Kodowanie e-maili

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

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 odpowiednio dla tematu i treści e-maila.

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

Wsparcie kultury w przeglądarce Word

Właściwość DocumentCulture w klasie WordConfig umożliwia wyraźne określenie kultury dla plików DOC i DOCX. Zapewnia to, że lokalizowana zawartość — takiej jak daty, waluty i liczby — jest renderowana dokładnie tak, jak w programie Microsoft Word. Jest to szczególnie przydatne w językach wymagających specyficznych 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)

Pobierz wymagane pliki CSS i JS

Aby Doconut działał prawidłowo, musisz dołączyć określone pliki CSS i JS do swojego projektu. Możesz pobrać plik ZIP zawierający wszystkie niezbędne pliki, korzystając z poniższego linku: