Steuern Sie externe Ressourcen in Excel zu PDF in Aspose.Cells

Einführung

Im heutigen digitalen Zeitalter ist die Konvertierung von Excel-Tabellen in PDF-Dokumente eine alltägliche Aufgabe. Egal, ob Sie Berichte, Finanzdaten oder Präsentationsmaterialien erstellen, Sie möchten sicherstellen, dass Ihre PDFs genau so aussehen, wie Sie es beabsichtigen. Aspose.Cells für .NET ist eine robuste Bibliothek, mit der Sie diesen Konvertierungsprozess bis ins kleinste Detail steuern können, insbesondere beim Umgang mit externen Ressourcen wie Bildern, die Ihre Excel-Dateien begleiten. In diesem Handbuch erfahren Sie, wie Sie externe Ressourcen während des Konvertierungsprozesses von Excel in PDF mit Aspose.Cells steuern können. Also, schnappen Sie sich Ihr Lieblingsgetränk und legen Sie los!

Voraussetzungen

Bevor wir ins Detail gehen, stellen wir sicher, dass Sie alles haben, was Sie brauchen, um loszulegen. Hier ist eine kurze Checkliste:

  1. Visual Studio oder eine beliebige .NET-kompatible IDE: Sie benötigen eine Umgebung zum Schreiben und Testen Ihres Codes.
  2. Aspose.Cells für .NET: Wenn Sie es noch nicht installiert haben, gehen Sie zu Aspose Downloads Seite und holen Sie sich die neueste Version.
  3. Grundkenntnisse in C#: Kenntnisse der Programmiersprache C# sind hilfreich. Wenn Sie sich bei bestimmten Konzepten nicht sicher sind, zögern Sie nicht, sie nachzuschlagen.
  4. Eine Excel-Beispieldatei: Bereiten Sie eine Excel-Datei mit allen externen Ressourcen vor, die Sie konvertieren möchten. Sie können die bereitgestellte Beispieldatei „samplePdfSaveOptions_StreamProvider.xlsx“ verwenden.
  5. Eine Bilddatei zum Testen: Diese wird während der Konvertierung als externe Ressource verwendet. Die Bilddatei „newPdfSaveOptions_StreamProvider.png“ ist ein guter Platzhalter.

Pakete importieren

Um loszulegen, müssen Sie die erforderlichen Namespaces aus der Aspose.Cells-Bibliothek importieren. Dies ist für den Zugriff auf die Funktionen von entscheidender Bedeutung. Stellen Sie sicher, dass Sie am Anfang Ihrer Datei die folgenden using-Direktiven hinzufügen:

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;

Diese Pakete stellen alle wichtigen Klassen und Methoden bereit, die Sie zum Ausführen Ihrer Aufgaben benötigen.

Schritt 1: Erstellen Sie Ihre Stream-Provider-Klasse

Der erste Punkt auf der Tagesordnung ist die Erstellung einer Stream-Provider-Klasse, die dieIStreamProvider Schnittstelle. Mit dieser Klasse können Sie steuern, wie externe Ressourcen geladen werden.

class MyStreamProvider : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        Debug.WriteLine("-----Close Stream-----");
    }
    public void InitStream(StreamProviderOptions options)
    {
        string sourceDir = "Your Document Directory";
        Debug.WriteLine("-----Init Stream-----");
        // Lesen Sie das neue Bild in einem Speicherstrom und weisen Sie es der Stream-Eigenschaft zu
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

In dieser Klasse:

  • CloseStream: Diese Methode wird aufgerufen, wenn der Stream geschlossen wird. Im Moment schreiben wir nur eine Debug-Nachricht zur Nachverfolgung.
  • InitStream: Hier beginnt die Magie. Hier lesen Sie Ihr externes Bild als Byte-Array, konvertieren es in einen Speicherstrom und weisen es demoptions.Stream Eigentum.

Schritt 2: Quell- und Ausgabeverzeichnisse einrichten

Nachdem Ihr Stream-Provider nun bereit ist, müssen Sie festlegen, wo sich Ihre Excel-Datei befindet und wo Sie Ihr PDF speichern möchten.

// Quellverzeichnis
string sourceDir = "Your Document Directory";
// Ausgabeverzeichnis
string outputDir = "Your Document Directory";

Einfach ersetzen"Your Document Directory" mit dem tatsächlichen Pfad auf Ihrem Computer, in dem sich Ihre Dateien befinden. Die Organisation Ihrer Dateien ist der Schlüssel!

Schritt 3: Laden Sie Ihre Excel-Datei

Als nächstes laden Sie die Excel-Datei, aus der Sie das PDF erstellen möchten.

// Quell-Excel-Datei mit externen Bildern laden
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

Wir verwenden dieWorkbook Klasse von Aspose.Cells, die Ihre Excel-Datei darstellt. Die Datei kann verschiedene externe Ressourcen wie Bilder enthalten, die Sie während der Konvertierung steuern möchten.

Schritt 4: PDF-Speicheroptionen festlegen

Bevor Sie die Arbeitsmappe als PDF speichern, geben Sie an, wie sie gespeichert werden soll. Sie können diese Optionen Ihren Anforderungen entsprechend anpassen.

// PDF-Speicheroptionen angeben – Stream-Anbieter
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // Jedes Blatt auf einer neuen Seite speichern

Hier erstellen wir eine neue Instanz vonPdfSaveOptions , mit dem Sie die Formatierung Ihrer PDF-Datei anpassen können. DieOnePagePerSheetOption ist praktisch, um sicherzustellen, dass jedes Excel-Blatt im endgültigen PDF eine eigene Seite erhält.

Schritt 5: Weisen Sie Ihren Stream-Anbieter zu

Wenn Ihre PDF-Optionen festgelegt sind, müssen Sie Aspose anweisen, Ihren benutzerdefinierten Stream-Anbieter für externe Ressourcen zu verwenden.

wb.Settings.StreamProvider = new MyStreamProvider();

Diese Linie verbindet IhreWorkbook Instanz mit demMyStreamProvider Klasse, die Sie zuvor erstellt haben. Das bedeutet, dass Ihr Anbieter bei der Konvertierung auf externe Ressourcen wie angegeben reagiert.

Schritt 6: Speichern Sie die Arbeitsmappe als PDF

Wenn alles eingestellt ist, ist es endlich an der Zeit, Ihre Excel-Arbeitsmappe als PDF zu speichern.

// Speichern Sie die Arbeitsmappe als PDF
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

Durch einen Anruf beiSave Methode für das Arbeitsmappenobjekt und Übergeben Ihres Ausgabeverzeichnisses zusammen mit den PDF-Optionen konvertieren Sie die Excel-Datei in eine schön formatierte PDF-Datei.

Schritt 7: Erfolgreiche Ausführung bestätigen

Abschließend ist es immer schön, bestätigen zu können, dass Ihr Vorgang erfolgreich war!

Console.WriteLine("ControlLoadingOfExternalResourcesInExcelToPDF executed successfully.\r\n");

Durch das Drucken einer Erfolgsmeldung auf der Konsole bleiben Sie über den Status Ihres Vorgangs informiert. Es ist eine gute Angewohnheit, diese kleinen Bestätigungen in Ihren Code aufzunehmen.

Abschluss

Da haben Sie es! Indem Sie diese einfachen Schritte befolgen, können Sie mit Aspose.Cells fachmännisch steuern, wie externe Ressourcen bei der Konvertierung von Excel in PDF gehandhabt werden. Das bedeutet, dass Ihre Dokumente jetzt Bilder und andere externe Elemente präzise einbinden können, wodurch jedes Mal ein ausgefeiltes Endprodukt gewährleistet wird.

Häufig gestellte Fragen

Was ist Aspose.Cells?

Aspose.Cells ist eine leistungsstarke Bibliothek für .NET-Entwickler, mit der Sie Excel-Dateien in verschiedenen Formaten erstellen, bearbeiten, konvertieren und rendern können.

Wie lade ich Aspose.Cells herunter?

Sie können die neueste Version von Aspose.Cells herunterladen von der Download-Link .

Kann ich Aspose.Cells kostenlos testen?

Ja! Sie können eine kostenlose Testversion erhalten, indem Sie die Seite „Kostenlose Testversion“ .

Wo finde ich Unterstützung für Aspose.Cells?

Bei Supportanfragen können Sie die Aspose Support-Forum .

Wie kann ich eine temporäre Lizenz für Aspose.Cells erhalten?

Sie können eine vorläufige Lizenz beantragen Hier .