Substituir Tag por Texto em TextBox no Excel

Introdução

Neste artigo, vamos nos aprofundar em uma tarefa específica: substituir tags por texto dentro de caixas de texto em uma planilha do Excel usando o Aspose.Cells. Vamos guiá-lo por todo o processo passo a passo, garantindo que você entenda cada detalhe. Ao final deste tutorial, você não apenas aprimorará sua compreensão do Aspose.Cells, mas também simplificará suas tarefas relacionadas ao Excel!

Pré-requisitos

Antes de começar, você precisará de algumas coisas prontas:

  1. Visual Studio: Certifique-se de ter o Visual Studio instalado. É um IDE flexível que torna a codificação em C# muito fácil.
  2. Biblioteca Aspose.Cells: Se você ainda não fez isso, baixe a biblioteca Aspose.Cells para .NET do sitepáginaVocê também pode obter uma versão de teste gratuita para conferir seus recursos.
  3. Conhecimento básico de C#: Um conhecimento básico de programação em C# ajudará muito você a seguir este guia facilmente. Agora que você está pronto, vamos para a parte divertida: escrever o código!

Pacotes de importação

Primeiro as coisas mais importantes — vamos importar os pacotes necessários. Isso é crucial porque sem as importações certas, seu código não reconhecerá as classes e métodos que usaremos.

Inicie seu projeto C#

Abra o Visual Studio e crie um novo projeto C#, de preferência um aplicativo de console, pois ele permitirá que você veja a saída facilmente.

Adicionar referência Aspose.Cells

  • Clique com o botão direito do mouse no seu projeto no Solution Explorer.
  • Selecione “Adicionar” > “Referência”.
  • Navegue até o local onde você baixou a biblioteca Aspose.Cells e inclua-a no seu projeto.

Importe os namespaces necessários

Depois de adicionar a referência, adicione o seguinteusing diretiva no topo do seu arquivo principal:

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

Isso lhe dá acesso às classes dentro do namespace Aspose.Cells. Agora que configuramos nosso ambiente, vamos para a parte mais interessante — codificação! Nosso objetivo é encontrar tags específicas em caixas de texto dentro de um arquivo Excel e substituí-las pelo texto fornecido.

Etapa 1: Defina o diretório de origem e saída

Primeiro, precisamos especificar onde nosso arquivo Excel de origem está localizado e onde queremos salvar a versão modificada.

// Diretório de origem e saída
string sourceDir = "Your Document Directory"; // Alterar para o seu diretório
string outputDir = "Your Document Directory"; // Alterar para o seu diretório

Etapa 2: Carregue a pasta de trabalho

É aqui que carregaremos nossa pasta de trabalho do Excel. Se o arquivo não existir, ele lançará um erro. Então, certifique-se de que o caminho do seu arquivo esteja correto!

Workbook wb = new Workbook(sourceDir + "sampleReplaceTagWithText.xlsx");

Aqui, estamos carregando um arquivo Excel existente chamadosampleReplaceTagWithText.xlsx.

Etapa 3: Definir tags e texto de substituição

Em seguida, precisamos definir as tags que estamos procurando e o que queremos usar para substituí-las.

string tag = "TAG_2$TAG_1";
string replace = "1$ys";

Neste exemplo, as tags são divididas usando$. Você pode substituir isso por qualquer delimitador que preferir.

Etapa 4: faça um loop sobre as tags e substitua

Criaremos um loop para percorrer cada tag que queremos substituir. É aqui que a mágica acontece!

for (int i = 0; i < tag.Split('$').Length; i++)
{
    sheetReplace(wb, "<" + tag.Split('$')[i] + ">", replace.Split('$')[i]);
}

Etapa 5: Salve a pasta de trabalho

Agora que fizemos nossas substituições, é hora de salvar a pasta de trabalho modificada em um formato desejado. Veja como a convertemos para um PDF.

PdfSaveOptions opts = new PdfSaveOptions();
wb.Save(outputDir + "outputReplaceTagWithText.pdf", opts);

Você também pode salvá-lo em vários outros formatos, incluindo XLSX.

Etapa 6: Implementar a lógica de substituição

É aqui que reside o coração da nossa funcionalidade. OsheetReplace O método tratará da substituição real nas planilhas do Excel.

public static void sheetReplace(Workbook workbook, string sFind, string sReplace)
{
    string finding = sFind;
    foreach (Worksheet sheet in workbook.Worksheets)
    {
        sheet.Replace(finding, sReplace);
        for (int j = 0; j < 3; j++)
        {
            if (sheet.PageSetup.GetHeader(j) != null)
                sheet.PageSetup.SetHeader(j, sheet.PageSetup.GetHeader(j).Replace(finding, sReplace));
                
            if (sheet.PageSetup.GetFooter(j) != null)
                sheet.PageSetup.SetFooter(j, sheet.PageSetup.GetFooter(j).Replace(finding, sReplace));
        }
    }
    foreach (Worksheet sheet in workbook.Worksheets)
    {
        sFind = sFind.Replace("<", "&lt;");
        sFind = sFind.Replace(">", "&gt;");
        foreach (Aspose.Cells.Drawing.TextBox mytextbox in sheet.TextBoxes)
        {
            if (mytextbox.HtmlText != null)
            {
                if (mytextbox.HtmlText.IndexOf(sFind) >= 0)
                {
                    mytextbox.HtmlText = mytextbox.HtmlText.Replace(sFind, sReplace);
                }
            }
        }
    }
}
  • Primeiro, percorremos cada planilha da pasta de trabalho.
  • Substituímos a tag principal não apenas no conteúdo da célula, mas também nos cabeçalhos e rodapés (se existirem).
  • Por fim, verificamos cada caixa de texto na planilha e substituímos o texto dentro delas, com base na tag que estamos procurando.

Conclusão

voilà! Agora você aprendeu como substituir tags por texto em caixas de texto em seus documentos do Excel usando o Aspose.Cells para .NET. Isso pode economizar muito tempo, especialmente ao lidar com tarefas repetitivas em planilhas.

Perguntas frequentes

Posso substituir tags em vários arquivos do Excel de uma só vez?

Sim, ao percorrer uma lista de arquivos, você pode aplicar a mesma lógica a vários arquivos do Excel.

Preciso de uma licença paga para usar o Aspose.Cells?

Você pode começar com um teste gratuito, mas para funcionalidade completa, você precisará comprar uma licença. ConfiraOpções de compra da Aspose.

Posso substituir imagens em caixas de texto usando Aspose.Cells?

Aspose.Cells lida principalmente com texto. No entanto, você pode manipular imagens separadamente, se necessário.

Em quais formatos posso salvar meu arquivo Excel modificado?

Você pode salvá-lo em vários formatos, incluindo XLSX, PDF, CSV, etc.

Onde posso encontrar suporte para o Aspose.Cells?

Você pode encontrar suporte e fazer perguntas noFórum Aspose.

Extrair texto do tipo de engrenagem Smart Art no Excel Girar texto com forma no Excel