Ovládání externích zdrojů v Excelu do PDF v Aspose.Cells

Zavedení

V dnešní digitální době je převod tabulek Excelu na dokumenty PDF běžným úkolem. Ať už se jedná o přípravu zpráv, finančních dat nebo prezentačních materiálů, chcete zajistit, aby vaše soubory PDF vypadaly přesně tak, jak je zamýšlíte. Aspose.Cells for .NET je robustní knihovna, která vám umožňuje řídit tento proces převodu do posledního detailu, zejména při manipulaci s externími zdroji, jako jsou obrázky, které doprovázejí vaše soubory Excel. V této příručce se ponoříme do toho, jak ovládat externí zdroje během procesu převodu Excel do PDF pomocí Aspose.Cells. Takže si vezměte svůj oblíbený nápoj a můžeme začít!

Předpoklady

Než se vrhneme na to, co se dá, ujistíme se, že máte vše, co potřebujete, abyste se mohli rozjet. Zde je rychlý kontrolní seznam:

  1. Visual Studio nebo jakékoli IDE kompatibilní s .NET: Budete chtít prostředí pro psaní a testování kódu.
  2. Aspose.Cells for .NET: Pokud jste jej ještě nenainstalovali, přejděte naAspose ke stažení stránku a stáhněte si nejnovější verzi.
  3. Základní znalost C#: Užitečná bude znalost programovacího jazyka C#. Pokud si nejste jisti nějakými pojmy, neváhejte si je vyhledat.
  4. Ukázkový soubor Excel: Připravte soubor Excel s jakýmikoli externími zdroji, které chcete převést. Můžete použít poskytnutý ukázkový soubor “samplePdfSaveOptions_StreamProvider.xlsx”.
  5. Soubor obrázku pro testování: Tento soubor bude použit jako externí zdroj během převodu. Soubor obrázku „newPdfSaveOptions_StreamProvider.png“ je dobrým zástupným symbolem.

Importujte balíčky

Chcete-li to nastartovat, budete muset importovat potřebné jmenné prostory z knihovny Aspose.Cells. To je klíčové pro přístup k jeho funkcím. Ujistěte se, že jste pomocí direktiv v horní části souboru přidali následující:

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

Tyto balíčky poskytnou všechny základní třídy a metody, které budete potřebovat k provádění svých úkolů.

Krok 1: Vytvořte třídu poskytovatele streamu

Prvním úkolem je vytvořit třídu poskytovatele streamu, která implementujeIStreamProvider rozhraní. Tato třída vám umožní řídit, jak se načítají externí zdroje.

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-----");
        // Přečtěte si nový obrázek v paměťovém streamu a přiřaďte jej vlastnosti Stream
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

V této třídě:

  • CloseStream: Tato metoda bude volána, když je stream uzavřen. Zatím jen píšeme ladicí zprávu pro sledování.
  • InitStream: Tady začíná kouzlo. Zde načtete svůj externí obrázek jako bajtové pole, převedete jej na paměťový proud a přiřadíte jejoptions.Stream vlastnictví.

Krok 2: Nastavte zdrojové a výstupní adresáře

Nyní, když je váš poskytovatel streamu připraven, je čas určit, kde se váš soubor Excel nachází a kam chcete uložit PDF.

// Zdrojový adresář
string sourceDir = "Your Document Directory";
// Výstupní adresář
string outputDir = "Your Document Directory";

Jednoduše vyměnit"Your Document Directory" se skutečnou cestou ve vašem počítači, kde jsou uloženy vaše soubory. Udržování pořádku v souborech je klíčové!

Krok 3: Načtěte soubor Excel

Dále načtete soubor Excel, ze kterého chcete vytvořit PDF.

// Načtěte zdrojový soubor Excel obsahující externí obrázky
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

PoužívámeWorkbook třídy z Aspose.Cells, která představuje váš soubor Excel. Soubor může obsahovat různé externí zdroje, jako jsou obrázky, které chcete během převodu ovládat.

Krok 4: Nastavte možnosti uložení PDF

Než sešit uložíte jako PDF, určete, jak jej chcete uložit. Tyto možnosti můžete upravit podle svých požadavků.

// Zadejte možnosti uložení PDF - Poskytovatel streamu
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // Uložte každý list na novou stránku

Zde vytváříme novou instanciPdfSaveOptions , která vám umožní přizpůsobit, jak bude váš PDF formátován. TheOnePagePerSheetTato možnost je užitečná pro zajištění toho, že každý list aplikace Excel dostane svou vlastní stránku ve výsledném PDF.

Krok 5: Přiřaďte svého poskytovatele streamování

Když máte nastavené možnosti PDF, musíte Aspose říct, aby používal vašeho vlastního poskytovatele streamu pro externí zdroje.

wb.Settings.StreamProvider = new MyStreamProvider();

Tato linka spojuje vašeWorkbook příklad sMyStreamProvider třídu, kterou jste dříve vytvořili. To znamená, že kdykoli během převodu narazíte na externí zdroje, váš poskytovatel s nimi naloží tak, jak je uvedeno.

Krok 6: Uložte sešit jako PDF

Když je vše nastaveno, je konečně čas uložit sešit aplikace Excel jako PDF.

// Uložte sešit do Pdf
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

Zavoláním naSave metodou na objekt sešitu a předáním výstupního adresáře spolu s možnostmi PDF převedete soubor Excel do krásně formátovaného PDF.

Krok 7: Potvrďte úspěšné provedení

Abychom vše uzavřeli, je vždy příjemné potvrdit, že váš proces byl úspěšný!

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

Vytištění zprávy o úspěchu na konzoli vám pomůže získat informace o stavu vaší operace. Je dobrým zvykem zahrnout tato malá potvrzení do vašeho kódu.

Závěr

Tady to máš! Dodržováním těchto jednoduchých kroků můžete odborně ovládat, jak se zachází s externími zdroji během převodu Excelu do PDF pomocí Aspose.Cells. To znamená, že vaše dokumenty mohou nyní přesně obsahovat obrázky a další externí prvky, což pokaždé zajistí vyleštěný konečný produkt.

FAQ

Co je Aspose.Cells?

Aspose.Cells je výkonná knihovna pro vývojáře .NET, která vám umožňuje vytvářet, manipulovat, převádět a vykreslovat soubory aplikace Excel v různých formátech.

Jak stáhnu Aspose.Cells?

Nejnovější verzi Aspose.Cells si můžete stáhnout zOdkaz ke stažení.

Mohu vyzkoušet Aspose.Cells zdarma?

Ano! Můžete získat bezplatnou zkušební verzi návštěvouBezplatná zkušební stránka.

Kde najdu podporu pro Aspose.Cells?

V případě jakýchkoli dotazů souvisejících s podporou můžete navštívit stránkuFórum podpory Aspose.

Jak mohu získat dočasnou licenci pro Aspose.Cells?

Můžete požádat o dočasnou licencizde.

Vyhněte se prázdné stránce ve výstupním PDF v Aspose.Cells Vytvořte záložku PDF pro graf v Aspose.Cells