Steuern Sie externe Ressourcen mit Aspose.Cells für .NET

Einführung

In der heutigen digitalen Landschaft ist die Konvertierung von Excel-Tabellen in PDF-Dokumente eine gängige und wichtige Aufgabe. Egal, ob Sie Berichte, Finanzdaten oder Präsentationsmaterialien erstellen, es ist entscheidend, dass Ihre PDFs das gewünschte Format widerspiegeln. Aspose.Cells für .NET bietet eine leistungsstarke Bibliothek, mit der Sie diesen Konvertierungsprozess detailliert steuern können, insbesondere beim Umgang mit externen Ressourcen wie Bildern. In diesem Handbuch erfahren Sie, wie Sie externe Ressourcen während des Konvertierungsprozesses von Excel in PDF mit Aspose.Cells effektiv verwalten können. Lassen Sie uns eintauchen!

Voraussetzungen

Bevor wir beginnen, stellen Sie sicher, dass Sie Folgendes bereit haben:

1. Visual Studio oder eine beliebige .NET-kompatible IDE: Dies wird Ihre Entwicklungsumgebung sein.
2. Aspose.Cells für .NET: Wenn Sie es noch nicht installiert haben, besuchen Sie dieAspose Downloads Seite, um die neueste Version zu erhalten.
3. Grundkenntnisse in C#: Kenntnisse in C# sind von Vorteil. Wenn Sie Erläuterungen zu bestimmten Konzepten benötigen, können Sie diese gerne nachschlagen.
4. Beispiel-Excel-Datei: Bereiten Sie eine Excel-Datei wie „samplePdfSaveOptions_StreamProvider.xlsx“ vor, die externe Ressourcen enthält, die Sie konvertieren möchten.
5. Bilddatei zum Testen: Verwenden Sie während der Konvertierung eine Bilddatei wie „newPdfSaveOptions_StreamProvider.png“ als externe Ressource.

Erforderliche Pakete importieren

Zu Beginn müssen Sie die erforderlichen Namespaces aus der Aspose.Cells-Bibliothek importieren. Fügen Sie oben in Ihrer C#-Datei die folgenden using-Direktiven hinzu:

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

Diese Namespaces stellen die wesentlichen Klassen und Methoden für Ihre Aufgaben bereit.

Schritt 1: Erstellen einer Stream-Provider-Klasse

Erstellen Sie zunächst eine Stream-Provider-Klasse, die Folgendes implementiert:IStreamProvider 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-----");
        
        // Laden Sie das Bild in einen Speicherstream
        byte[] bts = File.ReadAllBytes(Path.Combine(sourceDir, "newPdfSaveOptions_StreamProvider.png"));
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

• CloseStream: Diese Methode wird aufgerufen, wenn der Stream geschlossen wird und derzeit eine Debug-Meldung protokolliert wird.
• InitStream: Diese Methode liest die externe Bilddatei als Byte-Array, konvertiert sie in einen Speicherstrom und weist sie demoptions.Stream Eigentum.

Schritt 2: Quell- und Ausgabeverzeichnisse einrichten

Definieren Sie als Nächstes die Verzeichnisse für Ihre Excel-Datei und das Ausgabe-PDF.

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

Ersetzen"Your Document Directory" durch den tatsächlichen Pfad auf Ihrem System, in dem sich Ihre Dateien befinden.

Schritt 3: Laden Sie Ihre Excel-Datei

Laden Sie nun die Excel-Datei, aus der Sie das PDF erstellen möchten.

// Laden Sie die Excel-Quelldatei mit externen Bildern
Workbook wb = new Workbook(sourceDir, "samplePdfSaveOptions_StreamProvider.xlsx");

DerWorkbook Die Klasse von Aspose.Cells stellt Ihre Excel-Datei dar, die verschiedene externe Ressourcen wie Bilder enthalten kann.

Schritt 4: PDF-Speicheroptionen festlegen

Bevor Sie die Arbeitsmappe als PDF speichern, geben Sie die gewünschten Speicheroptionen an.

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

Dadurch wird eine Instanz vonPdfSaveOptions , mit dem Sie das PDF-Format anpassen können. DieOnePagePerSheet stellt sicher, dass jedes Excel-Blatt im endgültigen PDF auf einer separaten Seite angezeigt wird.

Schritt 5: Weisen Sie Ihren Stream-Anbieter zu

Verbinden SieWorkbook Instanz mit demMyStreamProvider Klasse, die Sie zuvor erstellt haben.

wb.Settings.StreamProvider = new MyStreamProvider();

Diese Zeile stellt sicher, dass Ihr benutzerdefinierter Anbieter bei der Konvertierung auf externe Ressourcen trifft und diese entsprechend verwaltet.

Schritt 6: Speichern Sie die Arbeitsmappe als PDF

Speichern Sie jetzt Ihre Excel-Arbeitsmappe als PDF.

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

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

Schritt 7: Erfolgreiche Ausführung bestätigen

Abschließend empfiehlt es sich, den erfolgreichen Abschluss des Vorgangs zu bestätigen.

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

Diese Nachricht informiert Sie über den Status Ihres Vorgangs und bietet nützliches Feedback.

Abschluss

Sie beherrschen jetzt die Steuerung externer Ressourcen bei der Konvertierung von Excel in PDF mit Aspose.Cells! Indem Sie diese Schritte befolgen, können Sie sicherstellen, dass Ihre Dokumente Bilder und andere externe Elemente korrekt enthalten, sodass jedes Mal ein ausgefeiltes Endprodukt entsteht.

Häufig gestellte Fragen

Was ist Aspose.Cells?

Aspose.Cells ist eine leistungsstarke Bibliothek für .NET-Entwickler, die das Erstellen, Bearbeiten, Konvertieren und Rendern von Excel-Dateien in verschiedenen Formaten ermöglicht.

Wie lade ich Aspose.Cells herunter?

Sie können die neueste Version herunterladen von derDownload-Link.

Kann ich Aspose.Cells kostenlos testen?

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

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

Bei Supportanfragen besuchen Sie bitte dieAspose Support-Forum.

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

Sie können eine vorläufige Lizenz beantragenHier.