Sledování průběhu převodu dokumentů programově v .NET

Zavedení

Chcete vylepšit svůj proces převodu dokumentů pomocí Aspose.Cells pro .NET? Pokud ano, jste na správném místě! V tomto tutoriálu se ponoříme hluboko do sledování průběhu převodu dokumentů aplikace Excel při jejich transformaci do formátu PDF. Nejen, že vás provedeme základními kroky, jak toho dosáhnout, ale také vám během cesty přidáme několik užitečných postřehů. Takže, pojďme začít!

Předpoklady

Než se vrhneme na to podstatné, co je sledování konverze dokumentů, měli byste mít splněno několik předpokladů:

1. Základní znalost C#: Protože ke kódování budeme používat C#, bude se nám hodit základní znalost tohoto programovacího jazyka.
2. Nainstalované Visual Studio: Toto bude sloužit jako naše vývojové prostředí. Můžete použít jakoukoli verzi, kterou preferujete, ale nejnovější je vždy dobrá volba.
3. Aspose.Cells for .NET: Ujistěte se, že máte nainstalovaný Aspose.Cells. Můžete si jej stáhnout zAspose webové stránky.
4. Soubor Excel: Připravte si vzorový soubor Excel pro převod. Můžete vytvořit jednoduchý.xlsx soubor, který chcete následovat.

Importujte balíčky

Nyní, když máme pokryty naše předpoklady, je čas naimportovat potřebné balíčky do vašeho projektu C#. Jak na to:

Vytvořit nový projekt

1. Otevřete Visual Studio a vytvořte nový projekt. Pro jednoduchost zvolte šablonu konzolové aplikace.

Přidejte odkaz do Aspose.Cells

2. Klikněte pravým tlačítkem na odkazy v Průzkumníku řešení, vyberte Přidat odkaz a přejděte k sestavení Aspose.Cells, pokud není přidáno automaticky. Správce balíčků NuGet můžete také použít spuštěním následujícího příkazu v konzole Správce balíčků:

Install-Package Aspose.Cells

Importovat jmenné prostory

3. V horní části vašehoProgram.cs soubor, přidejte následující pomocí direktivy:

using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Nyní jsme s nastavením projektu připraveni!

Po položených základech rozeberme skutečný proces sledování konverze dokumentů do stravitelných kroků.

Krok 1: Definujte své adresáře

Začněte zadáním adresářů, kde budou umístěny vaše zdrojové a výstupní soubory. Jak na to:

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

Nezapomeňte vyměnit"Your Document Directory" se skutečnou cestou ve vašem systému. Pomůže vám to snadno najít vaše soubory.

Krok 2: Načtěte sešit

Dále musíte načíst sešit aplikace Excel pomocíWorkbook třída. Zde je postup:

Workbook workbook = new Workbook(sourceDir + "PagesBook1.xlsx");

Tento řádek kódu vytváří aWorkbook objekt, který nám umožní interakci se souborem Excel, který jsme zadali.

Krok 3: Nastavte možnosti ukládání PDF

Nyní nastavíme možnosti uložení PDF. Tady začíná kouzlo sledování pokroku. Vytvoříte instanciPdfSaveOptions a přiřadit mu zpětné volání.

PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
pdfSaveOptions.PageSavingCallback = new TestPageSavingCallback();

Přiřazením vlastního zpětného volání (TestPageSavingCallback), můžeme implementovat vlastní logiku pro sledování průběhu konverze stránek.

Krok 4: Uložte sešit jako PDF

Když je vše nastaveno, je čas uložit sešit jako PDF. PoužijteSave metodaWorkbook třída takto:

workbook.Save(outputDir + "DocumentConversionProgress.pdf", pdfSaveOptions);

Tento řádek spustí proces převodu a vyvolá naše metody zpětného volání, když se stránky zpracovávají.

Krok 5: Implementujte třídu zpětného volání

Nyní vytvořímeTestPageSavingCallback třída. Zde definujete, co se stane na začátku a na konci ukládání každé stránky.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Nevydávejte stránky před indexem stránky 2.
        if (args.PageIndex < 2)
        {
            args.IsToOutput = false;
        }
    }
    public void PageEndSaving(PageEndSavingArgs args)
    {
        Console.WriteLine("End saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Nevypisujte stránky po indexu stránky 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}

• PageStartSavingTato metoda se volá těsně předtím, než se stránka začne ukládat. Zde zaznamenáme začátek procesu ukládání pro každou stránku. Navíc můžeme řídit, zda se má stránka vytisknout nebo ne. V tomto případě jsou stránky před indexem 2 přeskočeny.
• PageEndSaving: Tato metoda se vyvolá po uložení stránky. Umožňuje vám zaznamenat konec ukládání pro každou stránku a kontrolovat, zda má být zpracováno více stránek. V tomto příkladu se zastavíme po indexu stránky 8.

Závěr

Gratuluji! Úspěšně jste implementovali systém pro sledování průběhu převodu dokumentů pomocí Aspose.Cells for .NET. Tento přístup vám nejen umožňuje sledovat proces převodu, ale také vám dává kontrolu nad tím, které stránky zahrnout nebo vyloučit, čímž je vaše správa dokumentů mnohem efektivnější.

FAQ

Co je Aspose.Cells?

Aspose.Cells je výkonná knihovna .NET, která umožňuje vývojářům vytvářet, manipulovat a převádět soubory Excelu programově.

Jak mohu získat bezplatnou zkušební verzi Aspose.Cells?

Můžete si stáhnout bezplatnou zkušební verzi zAspose webové stránky.

Je možné přizpůsobit proces převodu?

Ano, pomocí zpětných volání si můžete přizpůsobit způsob zpracování stránek během převodu.

Mohu ovládat název výstupního souboru?

Absolutně! Při ukládání sešitu můžete zadat libovolný název výstupního souboru.

Kde najdu podporu pro Aspose.Cells?

Podporu můžete získat návštěvou stránkyAspose fórum.