Wie man Doconut aktualisiert

Befolgen Sie diese Schritte, um von Version 1.0.5.2 oder niedriger zu aktualisieren.

.NET Framework 4.7

Web.config-Konfiguration

Der Viewer erfordert, dass HttpHandler über die web.config-Datei registriert wird. Je nach Ihrer IIS-Version kann dies mit dem folgenden Abschnitt, der in der web.config definiert ist, durchgeführt werden.

Unter IIS 7:

xml
<httpHandlers>
  <add verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</httpHandlers>

IIS 7 und höher:

xml
<handlers>
  <add name="DocImage" verb="GET,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
</handlers>

Registrierung in ASPX‑Seiten aktualisieren

Ändern Sie die Assembly‑Registrierung in Ihren ASPX‑Seiten.

Alt:

aspx
<%@ Register Assembly="DocumentViewer" Namespace="DotnetDaddy.DocumentViewer" TagPrefix="asp" %>

Neu:

aspx
<%@ Register Assembly="Doconut" Namespace="Doconut" TagPrefix="asp" %>

Steuerelement‑Tag aktualisieren

Aktualisieren Sie das Steuerelement‑Tag von DocViewer zu Viewer.

Alt:

aspx
<asp:DocViewer ID="ctlDoc" runat="server"/>

Neu:

aspx
<asp:Viewer ID="ctlDoc" runat="server"/>

Namespaces aktualisieren

Doconut 24.3.0 hat die Namespaces umbenannt. Fügen Sie die neuen DLLs hinzu: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll und Doconut.Clouds.dll.

Neue Usings:

csharp
using Doconut;
using Doconut.Configs;
using Doconut.Clouds;

Initialisierung:

csharp
var viewer = new Viewer();

Paketabhängigkeiten

  • Newtonsoft.Json 13.0.3
  • System.Text.Encoding.CodePages 6.0.0
  • System.Text.Json 6.0.0

.NET Standard / Core

Namespaces aktualisieren

Doconut 24.3.0 hat die Namespaces umbenannt. Fügen Sie die neuen DLLs hinzu: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll und Doconut.Clouds.dll.

Neue Usings:

csharp
using Doconut;
using Doconut.Configs;
using Doconut.Clouds;

Initialisierung:

csharp
using System;

// Viewer-Instanzen werden jetzt aus einer Fabrik, DI container oder einem anderen Anbieter bezogen.
// Ersetzen Sie die Implementierung von GetViewer durch Ihre tatsächliche Beschaffungslogik.
Viewer GetViewer() => throw new NotImplementedException();

var viewer = GetViewer(); // eine Viewer-Instanz erhalten

Paketabhängigkeiten

  • Microsoft.Extensions.Caching.Abstractions 3.1.10
  • SkiaSharp 2.88.6
  • Newtonsoft.Json 13.0.3
  • System.Drawing.Common 6.0.0
  • System.Text.Json 6.0.0
  • System.Text.Encoding.CodePages 7.0.0

.NET 6 oder höher

Namespaces aktualisieren

Doconut 24.3.0 hat die Namespaces umbenannt. Fügen Sie die neuen DLLs hinzu: Doconut.dll, Doconut.Formats.dll, Doconut.Configs.dll und Doconut.Clouds.dll.

Neue Usings:

csharp
// Aktuelle .NET 6-Integration: Viewer kommt aus DI und das Öffnen von Dokumenten ist asynchron.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Initialisierung:

csharp
app.MapPost("/api/open", async (Viewer viewer) =>
{
    // Das token ist undurchsichtig — geben Sie es an das Widget weiter, protokollieren oder speichern Sie es niemals.
    string token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Paketabhängigkeiten

  • Microsoft.Extensions.Caching.Abstractions 3.1.10
  • Newtonsoft.Json 13.0.3
  • SkiaSharp 2.88.6
  • System.Drawing.Common 7.0.0
  • System.Text.Encoding.CodePages 7.0.0

War diese Seite hilfreich?