Śledzenie postępu konwersji dokumentów programowo w środowisku .NET

Wstęp

Czy chcesz udoskonalić proces konwersji dokumentów za pomocą Aspose.Cells dla .NET? Jeśli tak, to jesteś we właściwym miejscu! W tym samouczku zagłębimy się w śledzenie postępu konwersji dokumentów Excela podczas ich przekształcania do formatu PDF. Nie tylko przeprowadzimy Cię przez niezbędne kroki, aby to osiągnąć, ale także wtrącimy kilka pomocnych spostrzeżeń po drodze. Więc zaczynajmy!

Wymagania wstępne

Zanim przejdziemy do szczegółów śledzenia konwersji dokumentów, należy spełnić kilka warunków wstępnych:

1. Podstawowa znajomość języka C#: Ponieważ będziemy kodować w języku C#, podstawowa znajomość tego języka programowania okaże się bardzo przydatna.
2. Zainstalowano Visual Studio: Będzie ono służyć jako nasze środowisko programistyczne. Możesz użyć dowolnej wersji, którą wolisz, ale najnowsza zawsze jest dobrym wyborem.
3. Aspose.Cells dla .NET: Upewnij się, że masz zainstalowany Aspose.Cells. Możesz go pobrać ze stronyStrona internetowa Aspose.
4. Plik Excela: Przygotuj przykładowy plik Excela do konwersji. Możesz utworzyć prosty.xlsx plik do śledzenia.

Importuj pakiety

Teraz, gdy mamy już spełnione nasze wymagania wstępne, czas zaimportować niezbędne pakiety do projektu C#. Oto jak to zrobić:

Utwórz nowy projekt

1. Otwórz program Visual Studio i utwórz nowy projekt. Wybierz szablon aplikacji konsoli dla uproszczenia.

Dodaj odniesienie do Aspose.Cells

2. Kliknij prawym przyciskiem myszy na References w Solution Explorer, wybierz Add Reference i przejdź do zestawu Aspose.Cells, jeśli nie został dodany automatycznie. Możesz również użyć NuGet Package Manager, uruchamiając następujące polecenie w Package Manager Console:

Install-Package Aspose.Cells

Importuj przestrzenie nazw

3. Na szczycie twojegoProgram.cs plik, dodaj następującą dyrektywę using:

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

Teraz mamy już wszystko gotowe do skonfigurowania naszego projektu!

Mając już podstawy, możemy podzielić proces śledzenia konwersji dokumentów na zrozumiałe kroki.

Krok 1: Zdefiniuj swoje katalogi

Zacznij od określenia katalogów, w których będą się znajdować pliki źródłowe i wyjściowe. Oto jak to zrobić:

// Katalog źródłowy
string sourceDir = "Your Document Directory";
// Katalog wyjściowy
string outputDir = "Your Document Directory";

Pamiętaj o wymianie"Your Document Directory" z rzeczywistą ścieżką w twoim systemie. To pomoże w łatwym zlokalizowaniu twoich plików.

Krok 2: Załaduj skoroszyt

Następnie należy załadować skoroszyt programu Excel za pomocąWorkbook klasa. Oto jak:

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

Ta linia kodu tworzyWorkbook obiekt, który umożliwi nam interakcję z określonym przez nas plikiem Excela.

Krok 3: Skonfiguruj opcje zapisywania pliku PDF

Teraz skonfigurujmy opcje zapisywania PDF. To tutaj zaczyna się magia śledzenia postępu. Utworzysz wystąpieniePdfSaveOptions i przypisz do niego wywołanie zwrotne.

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

Przypisując niestandardowe wywołanie zwrotne (TestPageSavingCallback), możemy wdrożyć własną logikę śledzenia postępu konwersji strony.

Krok 4: Zapisz skoroszyt jako plik PDF

Po skonfigurowaniu wszystkiego nadszedł czas, aby zapisać skoroszyt jako plik PDF. UżyjSave metodaWorkbook klasa taka:

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

Ten wiersz uruchomi proces konwersji i wywoła nasze metody wywołania zwrotnego podczas przetwarzania stron.

Krok 5: Implementacja klasy wywołania zwrotnego

Teraz utwórzmyTestPageSavingCallback klasa. Tutaj definiujesz, co dzieje się na początku i na końcu zapisywania każdej strony.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Nie wyprowadzaj stron przed indeksem strony 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);
        // Nie wyprowadzaj stron po indeksie 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}

• PageStartSavingTa metoda jest wywoływana tuż przed rozpoczęciem zapisywania strony. Tutaj rejestrujemy rozpoczęcie procesu zapisywania dla każdej strony. Dodatkowo możemy kontrolować, czy wyprowadzić stronę, czy nie. W tym przypadku strony przed indeksem 2 są pomijane.
• PageEndSaving: Ta metoda jest wywoływana po zapisaniu strony. Umożliwia ona rejestrowanie zakończenia zapisywania dla każdej strony i kontrolowanie, czy należy przetworzyć więcej stron. W tym przykładzie zatrzymujemy się po indeksie strony 8.

Wniosek

Gratulacje! Udało Ci się wdrożyć system śledzenia postępu konwersji dokumentów przy użyciu Aspose.Cells dla .NET. To podejście nie tylko pozwala Ci monitorować proces konwersji, ale także daje Ci kontrolę nad tym, które strony uwzględnić lub wykluczyć, dzięki czemu zarządzanie dokumentami jest znacznie bardziej wydajne.

Najczęściej zadawane pytania

Czym jest Aspose.Cells?

Aspose.Cells to zaawansowana biblioteka .NET umożliwiająca programistom programowe tworzenie, edytowanie i konwertowanie plików Excel.

Jak mogę otrzymać bezpłatną wersję próbną Aspose.Cells?

Darmową wersję próbną możesz pobrać ze stronyStrona internetowa Aspose.

Czy można dostosować proces konwersji?

Tak, używając wywołań zwrotnych, możesz dostosować sposób przetwarzania stron podczas konwersji.

Czy mogę kontrolować nazwę pliku wyjściowego?

Oczywiście! Możesz określić dowolną nazwę pliku wyjściowego podczas zapisywania skoroszytu.

Gdzie mogę znaleźć pomoc dotyczącą Aspose.Cells?

Możesz uzyskać pomoc odwiedzając stronęForum Aspose.