A dokumentumkonverzió előrehaladásának nyomon követése programozottan .NET-ben

Bevezetés

Szeretné javítani a dokumentumkonverziós folyamatot az Aspose.Cells for .NET használatával? Ha igen, akkor jó helyen jársz! Ebben az oktatóanyagban mélyrehatóan nyomon követjük az Excel-dokumentumok átalakítási folyamatát, amint azok PDF formátumba kerülnek. Nemcsak az eléréséhez szükséges alapvető lépéseken vezetjük végig, hanem néhány hasznos betekintést is megszórunk az út során. Szóval, kezdjük!

Előfeltételek

Mielőtt belevágnánk a dokumentumkonverzió nyomon követésének aprólékos dolgaiba, meg kell felelnie néhány előfeltételnek:

  1. Alapvető C# ismerete: Mivel a kódoláshoz C#-t fogunk használni, hasznos lesz ennek a programozási nyelvnek az alapvető ismerete.
  2. Visual Studio telepítve: Ez lesz a fejlesztői környezetünk. Bármelyik verziót használhatja, de a legújabb mindig jó választás.
  3. Aspose.Cells for .NET: Győződjön meg arról, hogy az Aspose.Cells telepítve van. Letöltheti aAspose honlapja.
  4. Excel-fájl: Készítsen egy minta Excel-fájlt a konvertáláshoz. Létrehozhat egy egyszerű.xlsx követendő fájl.

Csomagok importálása

Most, hogy teljesítettük az előfeltételeinket, ideje importálni a szükséges csomagokat a C# projektbe. Íme, hogyan kell csinálni:

Hozzon létre egy új projektet

  1. Nyissa meg a Visual Studio-t, és hozzon létre egy új projektet. Válasszon egy konzolalkalmazássablont az egyszerűség kedvéért.

Adja hozzá az Aspose.Cells hivatkozást

  1. Kattintson a jobb gombbal a Referenciákra a Solution Explorerben, válassza a Hivatkozás hozzáadása lehetőséget, és navigáljon az Aspose.Cells összeállításhoz, ha az nem kerül automatikusan hozzáadásra. A NuGet Package Managert a következő parancs futtatásával is használhatja a Package Manager konzolon:
Install-Package Aspose.Cells

Névterek importálása

  1. A te tetejénProgram.cs fájlt, direktíva használatával adja hozzá a következőket:
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Most már készen is vagyunk a projekt beállításával!

Az alapok lefektetésével bontsuk le a dokumentumok konvertálásának nyomon követésének folyamatát emészthető lépésekre.

1. lépés: Határozza meg a könyvtárait

Kezdje azzal, hogy adja meg azokat a könyvtárakat, ahol a forrás- és kimeneti fájlok lesznek. Íme, hogyan kell csinálni:

// Forrás könyvtár
string sourceDir = "Your Document Directory";
// Kimeneti könyvtár
string outputDir = "Your Document Directory";

Mindenképpen cserélje ki"Your Document Directory" a rendszer tényleges elérési útjával. Ez segít a fájlok könnyű megtalálásában.

2. lépés: Töltse be a munkafüzetet

Ezután be kell töltenie az Excel-munkafüzetet aWorkbook osztály. Íme, hogyan:

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

Ez a kódsor létrehozza aWorkbook objektum, amely lehetővé teszi számunkra, hogy kapcsolatba léphessünk az általunk megadott Excel-fájllal.

3. lépés: Állítsa be a PDF mentési beállításokat

Most állítsuk be a PDF mentési beállításokat. Itt kezdődik a haladás követésének varázsa. Létrehoz egy példánytPdfSaveOptions és rendeljen hozzá visszahívást.

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

Egyéni visszahívás hozzárendelésével (TestPageSavingCallback), megvalósíthatjuk saját logikánkat az oldalkonverziós folyamat nyomon követésére.

4. lépés: Mentse el a munkafüzetet PDF formátumban

Miután minden be van állítva, ideje elmenteni a munkafüzetet PDF formátumban. Használja aSave módszere aWorkbook osztály így:

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

Ez a sor elindítja a konverziós folyamatot, és meghívja visszahívási módszereinket az oldalak feldolgozása közben.

5. lépés: Valósítsa meg a visszahívási osztályt

Most hozzuk létre aTestPageSavingCallback osztály. Itt határozhatja meg, hogy mi történjen az egyes oldalak mentésének elején és végén.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Ne adjon ki oldalakat a 2. oldalindex előtt.
        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);
        // Ne adjon ki oldalakat a 8. oldalindex után.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}
  • PageStartSavingEzt a módszert közvetlenül az oldal mentése előtt hívják meg. Itt minden oldalnál naplózzuk a mentési folyamat kezdetét. Ezenkívül szabályozhatjuk, hogy kiadjuk-e az oldalt vagy sem. Ebben az esetben a 2. index előtti oldalak kimaradnak.
  • PageEndSaving: Ez a módszer az oldal mentése után kerül meghívásra. Lehetővé teszi a naplózást, amikor az egyes oldalak mentése véget ér, és szabályozhatja, hogy további oldalakat kell-e feldolgozni. Ebben a példában a 8. oldalindex után megállunk.

Következtetés

Gratulálok! Sikeresen implementált egy olyan rendszert, amely nyomon követi a dokumentumok konvertálásának folyamatát az Aspose.Cells for .NET használatával. Ez a megközelítés nemcsak az átalakítási folyamat nyomon követését teszi lehetővé, hanem azt is szabályozhatja, hogy mely oldalakat vegye fel vagy zárja ki, így sokkal hatékonyabbá válik a dokumentumkezelés.

GYIK

Mi az Aspose.Cells?

Az Aspose.Cells egy hatékony .NET-könyvtár, amely lehetővé teszi a fejlesztők számára Excel-fájlok programozott létrehozását, kezelését és konvertálását.

Hogyan szerezhetem be az Aspose.Cells ingyenes próbaverzióját?

Ingyenes próbaverziót tölthet le a webhelyrőlAspose honlapja.

Testreszabható az átalakítási folyamat?

Igen, a visszahívások segítségével testreszabhatja az oldalak feldolgozását a konverzió során.

Szabályozhatom a kimeneti fájl nevét?

Teljesen! A munkafüzet mentésekor bármilyen nevet megadhat a kimeneti fájlnak.

Hol találok támogatást az Aspose.Cells számára?

Támogatást kaphat, ha ellátogat aAspose fórum.

Munkafüzet mentése szigorú nyílt XML-táblázatformátumba .NET-ben A TIFF dokumentumkonverziós folyamatának nyomon követése programozottan .NET-ben