Beheer externe bronnen in Excel naar PDF in Aspose.Cells

Invoering

In het digitale tijdperk van vandaag is het converteren van Excel-spreadsheets naar PDF-documenten een veelvoorkomende taak. Of het nu gaat om het voorbereiden van rapporten, financiële gegevens of presentatiemateriaal, u wilt er zeker van zijn dat uw PDF’s er precies zo uitzien als u wilt. Aspose.Cells voor .NET is een robuuste bibliotheek waarmee u dit conversieproces tot in de puntjes kunt beheren, vooral bij het verwerken van externe bronnen zoals afbeeldingen die bij uw Excel-bestanden horen. In deze handleiding duiken we in hoe u externe bronnen kunt beheren tijdens het conversieproces van Excel naar PDF met behulp van Aspose.Cells. Dus pak uw favoriete drankje en laten we beginnen!

Vereisten

Voordat we in de details duiken, zorgen we ervoor dat je alles hebt wat je nodig hebt om te beginnen. Hier is een snelle checklist:

  1. Visual Studio of een andere .NET-compatibele IDE: u hebt een omgeving nodig om uw code te schrijven en te testen.
  2. Aspose.Cells voor .NET: Als u het nog niet hebt geïnstalleerd, ga dan naar deAspose-downloads pagina en download de nieuwste versie.
  3. Basiskennis van C#: Kennis van de programmeertaal C# is handig. Als u onzeker bent over bepaalde concepten, aarzel dan niet om ze op te zoeken.
  4. Een voorbeeld Excel-bestand: Bereid een Excel-bestand voor met alle externe bronnen die u wilt converteren. U kunt het meegeleverde voorbeeldbestand “samplePdfSaveOptions_StreamProvider.xlsx” gebruiken.
  5. Een afbeeldingsbestand voor testen: Dit wordt gebruikt als externe bron tijdens de conversie. Het afbeeldingsbestand “newPdfSaveOptions_StreamProvider.png” is een goede tijdelijke aanduiding.

Pakketten importeren

Om te beginnen moet u de benodigde namespaces importeren uit de Aspose.Cells-bibliotheek. Dit is cruciaal voor toegang tot de functionaliteiten. Zorg ervoor dat u de volgende using directives boven aan uw bestand toevoegt:

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

Deze pakketten bieden alle essentiële klassen en methoden die u nodig hebt om uw taken uit te voeren.

Stap 1: Maak uw streamproviderklasse

De eerste taak is het creëren van een streamproviderklasse die deIStreamProvider interface. Met deze klasse kunt u bepalen hoe externe bronnen worden geladen.

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-----");
        // Lees de nieuwe afbeelding in een geheugenstroom en wijs deze toe aan de eigenschap Stream
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

In deze klas:

  • CloseStream: Deze methode wordt aangeroepen wanneer de stream gesloten is. Voor nu schrijven we alleen een debugbericht voor tracking.
  • InitStream: Dit is waar de magie begint. Hier leest u uw externe afbeelding als een byte-array, converteert u deze naar een geheugenstroom en wijst u deze toe aan deoptions.Stream eigendom.

Stap 2: Bron- en uitvoermappen instellen

Nu uw streamprovider gereed is, is het tijd om te bepalen waar uw Excel-bestand zich bevindt en waar u uw PDF wilt opslaan.

// Bron directory
string sourceDir = "Your Document Directory";
// Uitvoermap
string outputDir = "Your Document Directory";

Gewoon vervangen"Your Document Directory" met het daadwerkelijke pad op uw computer waar uw bestanden zich bevinden. Uw bestanden georganiseerd houden is de sleutel!

Stap 3: Laad uw Excel-bestand

Vervolgens laadt u het Excel-bestand waarvan u de PDF wilt maken.

// Bron Excel-bestand laden met externe afbeeldingen
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

Wij gebruiken deWorkbook klasse van Aspose.Cells, dat uw Excel-bestand vertegenwoordigt. Het bestand kan verschillende externe bronnen bevatten, zoals afbeeldingen die u tijdens de conversie wilt beheren.

Stap 4: PDF-opslagopties instellen

Voordat u de werkmap opslaat als PDF, specificeren we hoe u deze wilt opslaan. U kunt deze opties aanpassen aan uw wensen.

// Geef PDF-opslagopties op - Streamprovider
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // Sla elk blad op een nieuwe pagina op

Hier maken we een nieuw exemplaar vanPdfSaveOptions , waarmee u kunt aanpassen hoe uw PDF wordt opgemaakt. DeOnePagePerSheetDeze optie is handig om ervoor te zorgen dat elk Excel-werkblad een eigen pagina krijgt in de uiteindelijke PDF.

Stap 5: Wijs uw streamprovider toe

Nadat u uw PDF-opties hebt ingesteld, moet u Aspose vertellen dat uw aangepaste streamprovider moet worden gebruikt voor externe bronnen.

wb.Settings.StreamProvider = new MyStreamProvider();

Deze lijn verbindt uwWorkbook bijvoorbeeld met deMyStreamProvider class die u eerder hebt gemaakt. Dit betekent dat wanneer er externe bronnen worden aangetroffen tijdens de conversie, uw provider deze zal verwerken zoals gespecificeerd.

Stap 6: Sla de werkmap op als PDF

Nu alles is ingesteld, is het tijd om uw Excel-werkmap op te slaan als PDF.

// Sla de werkmap op als pdf
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

Door deSave Door de methode op het werkmapobject toe te passen en de uitvoermap samen met de PDF-opties door te geven, converteert u het Excel-bestand naar een prachtig opgemaakte PDF.

Stap 7: Bevestig succesvolle uitvoering

Om het af te ronden: het is altijd fijn om te bevestigen dat uw proces succesvol is geweest!

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

Door een succesbericht naar de console te printen, blijft u op de hoogte van de status van uw operatie. Het is een goede gewoonte om deze kleine bevestigingen in uw code op te nemen.

Conclusie

Daar heb je het! Door deze eenvoudige stappen te volgen, kun je vakkundig bepalen hoe externe bronnen worden verwerkt tijdens Excel naar PDF-conversies met Aspose.Cells. Dit betekent dat je documenten nu nauwkeurig afbeeldingen en andere externe elementen kunnen bevatten, wat elke keer een gepolijst eindproduct garandeert.

Veelgestelde vragen

Wat is Aspose.Cells?

Aspose.Cells is een krachtige bibliotheek voor .NET-ontwikkelaars waarmee u Excel-bestanden in verschillende formaten kunt maken, bewerken, converteren en weergeven.

Hoe download ik Aspose.Cells?

U kunt de nieuwste versie van Aspose.Cells downloaden van deDownloadlink.

Kan ik Aspose.Cells gratis uitproberen?

Ja! U kunt een gratis proefperiode krijgen door deGratis proefpagina.

Waar kan ik ondersteuning vinden voor Aspose.Cells?

Voor vragen over ondersteuning kunt u terecht op deAspose Ondersteuningsforum.

Hoe kan ik een tijdelijke licentie voor Aspose.Cells verkrijgen?

U kunt een tijdelijke vergunning aanvragenhier.

Vermijd lege pagina's in de uitvoer-PDF in Aspose.Cells Maak een PDF-bladwijzer voor een grafiekblad in Aspose.Cellen