Acompanhamento do progresso da conversão de documentos programaticamente no .NET

Introdução

Você está procurando aprimorar seu processo de conversão de documentos usando o Aspose.Cells para .NET? Se sim, você está no lugar certo! Neste tutorial, vamos nos aprofundar no rastreamento do progresso da conversão de documentos do Excel conforme eles são transformados em formato PDF. Não apenas o guiaremos pelas etapas essenciais para conseguir isso, mas também daremos alguns insights úteis ao longo do caminho. Então, vamos começar!

Pré-requisitos

Antes de entrarmos nos detalhes do rastreamento de conversão de documentos, há alguns pré-requisitos que você deve ter em mente:

  1. Conhecimento básico de C#: como usaremos C# para codificar, um conhecimento fundamental dessa linguagem de programação será útil.
  2. Visual Studio instalado: Isso servirá como nosso ambiente de desenvolvimento. Você pode usar qualquer versão que preferir, mas a mais recente é sempre uma boa escolha.
  3. Aspose.Cells para .NET: Certifique-se de ter o Aspose.Cells instalado. Você pode baixá-lo doSite Aspose.
  4. Um arquivo Excel: Tenha um arquivo Excel de exemplo pronto para conversão. Você pode criar um arquivo Excel simples.xlsx arquivo para acompanhar.

Pacotes de importação

Agora que cobrimos nossos pré-requisitos, é hora de importar os pacotes necessários para seu projeto C#. Veja como fazer isso:

Criar um novo projeto

  1. Abra o Visual Studio e crie um novo projeto. Escolha um modelo Console App para simplificar.

Adicionar referência a Aspose.Cells

  1. Clique com o botão direito do mouse em References no Solution Explorer, selecione Add Reference e navegue até o assembly Aspose.Cells se ele não for adicionado automaticamente. Você também pode usar o NuGet Package Manager executando o seguinte comando no Package Manager Console:
Install-Package Aspose.Cells

Importar namespaces

  1. No topo do seuProgram.cs arquivo, adicione a seguinte diretiva using:
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Agora estamos prontos com a configuração do nosso projeto!

Com as bases estabelecidas, vamos dividir o processo real de rastreamento da conversão de documentos em etapas mais fáceis de entender.

Etapa 1: Defina seus diretórios

Comece especificando os diretórios onde seus arquivos de origem e saída residirão. Veja como fazer isso:

// Diretório de origem
string sourceDir = "Your Document Directory";
// Diretório de saída
string outputDir = "Your Document Directory";

Certifique-se de substituir"Your Document Directory" com o caminho real no seu sistema. Isso ajudará a localizar seus arquivos facilmente.

Etapa 2: Carregue a pasta de trabalho

Em seguida, você precisa carregar sua pasta de trabalho do Excel usando oWorkbook classe. Veja como:

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

Esta linha de código cria umWorkbook objeto que nos permitirá interagir com o arquivo Excel que especificamos.

Etapa 3: Configurar opções de salvamento de PDF

Agora, vamos configurar as opções de salvamento do PDF. É aqui que a mágica do rastreamento do progresso começa. Você criará uma instância dePdfSaveOptions e atribuir um retorno de chamada a ele.

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

Ao atribuir um retorno de chamada personalizado (TestPageSavingCallback), podemos implementar nossa própria lógica para rastrear o progresso da conversão de páginas.

Etapa 4: Salve a pasta de trabalho como PDF

Com tudo configurado, é hora de salvar sua pasta de trabalho como um PDF. Use oSave método doWorkbook classe assim:

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

Esta linha acionará o processo de conversão e invocará nossos métodos de retorno de chamada enquanto as páginas são processadas.

Etapa 5: Implementar a classe de retorno de chamada

Agora vamos criar oTestPageSavingCallback class. É aqui que você define o que acontece no início e no fim do salvamento de cada página.

public class TestPageSavingCallback : IPageSavingCallback
{
    public void PageStartSaving(PageStartSavingArgs args)
    {
        Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
        // Não imprima páginas antes do índice de página 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);
        // Não imprima páginas após o índice de página 8.
        if (args.PageIndex >= 8)
        {
            args.HasMorePages = false;
        }
    }
}
  • PageStartSavingEste método é chamado logo antes de uma página começar a salvar. Aqui, registramos o início do processo de salvamento para cada página. Além disso, podemos controlar se queremos ou não imprimir a página. Neste caso, as páginas antes do índice 2 são ignoradas.
  • PageEndSaving: Este método é invocado após uma página ter sido salva. Ele permite que você registre quando o salvamento termina para cada página e controle se mais páginas devem ser processadas. Neste exemplo, paramos após o índice de página 8.

Conclusão

Parabéns! Você implementou com sucesso um sistema para rastrear o progresso da conversão de documentos usando o Aspose.Cells for .NET. Essa abordagem não só permite que você monitore o processo de conversão, mas também lhe dá controle sobre quais páginas incluir ou excluir, tornando seu gerenciamento de documentos muito mais eficiente.

Perguntas frequentes

O que é Aspose.Cells?

Aspose.Cells é uma poderosa biblioteca .NET que permite aos desenvolvedores criar, manipular e converter arquivos do Excel programaticamente.

Como posso obter uma avaliação gratuita do Aspose.Cells?

Você pode baixar uma versão de avaliação gratuita emSite Aspose.

É possível personalizar o processo de conversão?

Sim, usando retornos de chamada, você pode personalizar como as páginas são processadas durante a conversão.

Posso controlar o nome do arquivo de saída?

Absolutamente! Você pode especificar qualquer nome para seu arquivo de saída ao salvar a pasta de trabalho.

Onde posso encontrar suporte para o Aspose.Cells?

Você pode obter suporte visitando oFórum Aspose.

Salvando a pasta de trabalho no formato de planilha Open XML estrito no .NET Acompanhamento do progresso da conversão de documentos para TIFF programaticamente no .NET