Abrindo arquivos CSV com o analisador preferencial

Introdução

Ao lidar com arquivos CSV, às vezes você quer lidar com diferentes tipos de dados com analisadores personalizados. Este tutorial irá guiá-lo sobre como abrir arquivos CSV com um analisador preferencial usando Aspose.Cells para .NET. Se você quer lidar com texto, datas ou outros formatos personalizados, este guia irá guiá-lo por cada etapa com uma explicação clara.

Pré-requisitos

Antes de mergulhar no código, vamos abordar os itens essenciais que você precisa para começar.

  1. Biblioteca Aspose.Cells para .NET: Certifique-se de ter a biblioteca Aspose.Cells instalada. Você pode baixá-laaqui . Você também pode usar o teste gratuitoaqui.
  2. Ambiente de desenvolvimento .NET: o Visual Studio é recomendado, mas qualquer IDE compatível com .NET funcionará.
  3. Conhecimento básico de C#: Este tutorial pressupõe que você esteja familiarizado com C# e programação orientada a objetos.

Pacotes de importação

Para usar o Aspose.Cells, você precisará importar os namespaces necessários no topo do seu arquivo C#:

using System.IO;
using Aspose.Cells;
using System;

Agora que definimos o cenário, vamos ver como abrir um arquivo CSV com um analisador preferido, lidando com diferentes formatos de dados, como texto e datas.

Etapa 1: Definir analisadores personalizados

Para manipular diferentes tipos de dados, como texto ou formatos de data específicos, você precisa definir analisadores personalizados. Em Aspose.Cells, os analisadores personalizados implementam oICustomParser interface.

1.1 Crie um analisador de texto

Este parser manipula valores de texto regulares. Ele não modifica o formato, então o valor é retornado como está.

class TextParser : ICustomParser
{
    public object ParseObject(string value)
    {
        return value;
    }
    public string GetFormat()
    {
        return "";
    }
}

OParseObject O método simplesmente retorna o valor de entrada. É como dizer: “Não mude nada, apenas me dê o texto!”

1.2 Crie um analisador de data

Para datas, você vai querer garantir que os dados CSV sejam analisados corretamente emDateTime objetos. Veja como você pode criar um analisador de data:

class DateParser : ICustomParser
{
    public object ParseObject(string value)
    {
        DateTime myDate = DateTime.ParseExact(value, "dd/MM/yyyy", 
            System.Globalization.CultureInfo.InvariantCulture);
        return myDate;
    }
    public string GetFormat()
    {
        return "dd/MM/yyyy";
    }
}

Neste analisador, usamosParseExact para garantir que a data seja interpretada corretamente com base em um formato predefinido ("dd/MM/yyyy"). Dessa forma, qualquer data no seu CSV que siga esse formato será processada sem problemas.

Etapa 2: Configurar opções de carga

Em seguida, você precisa configurar como o arquivo CSV é carregado. Isso é feito usando oTxtLoadOptions classe, que permite especificar opções de análise, incluindo codificação e analisadores personalizados.

2.1 Configurar opções de carga

Começaremos inicializando oTxtLoadOptions e definir parâmetros-chave, como o separador e a codificação:

TxtLoadOptions oTxtLoadOptions = new TxtLoadOptions(LoadFormat.Csv);
oTxtLoadOptions.Separator = Convert.ToChar(",");
oTxtLoadOptions.Encoding = Encoding.UTF8;
oTxtLoadOptions.ConvertDateTimeData = true;
  • Separador: define o caractere usado para separar valores no arquivo CSV (vírgulas, neste caso).
  • Codificação: Usamos codificação UTF-8 para lidar com uma ampla variedade de caracteres.
  • ConvertDateTimeData: Definir como verdadeiro garante que os valores de data serão convertidos automaticamente paraDateTime objetos quando possível.

2.2 Aplicar analisadores personalizados

Em seguida, atribuiremos os analisadores que criamos anteriormente para manipular os valores no CSV:

oTxtLoadOptions.PreferredParsers = new ICustomParser[] 
{ 
    new TextParser(), 
    new DateParser() 
};

Isso informa ao Aspose.Cells para usar oTextParser para valores de texto gerais e oDateParserpara quaisquer campos de data encontrados no arquivo CSV.

Etapa 3: Carregue e leia o arquivo CSV

Agora que as opções de carregamento estão configuradas, você pode carregar o arquivo CSV em umAspose.Cells.Workbook objeto.

3.1 Carregar o arquivo CSV

Carregamos o arquivo CSV passando o caminho do arquivo e o configuradoTxtLoadOptions para oWorkbook construtor:

string sourceDir = "Your Document Directory";
Workbook oExcelWorkBook = new Aspose.Cells.Workbook(sourceDir + "samplePreferredParser.csv", oTxtLoadOptions);

Esta etapa converte seus dados CSV em uma pasta de trabalho do Excel totalmente funcional, com cada valor analisado de acordo com suas regras preferidas.

Etapa 4: Acessar e exibir dados da célula

Depois que o CSV for carregado na pasta de trabalho, você pode começar a trabalhar com os dados. Por exemplo, você pode querer imprimir o tipo e o valor de células específicas.

4.1 Recuperar e exibir a célula A1

Vamos recuperar a primeira célula (A1) e exibir seu valor e tipo:

Cell oCell = oExcelWorkBook.Worksheets[0].Cells["A1"];
Console.WriteLine("A1: " + oCell.Type.ToString() + " - " + oCell.DisplayStringValue);

Aqui, oType propriedade mostra o tipo de dados (comoString ouDateTime ), eDisplayStringValue fornece o valor formatado.

4.2 Recuperar e exibir a célula B1

Da mesma forma, podemos recuperar e exibir outra célula, como B1:

oCell = oExcelWorkBook.Worksheets[0].Cells["B1"];
Console.WriteLine("B1: " + oCell.Type.ToString() + " - " + oCell.DisplayStringValue);

Esse processo pode ser repetido para quantas células você precisar inspecionar.

Etapa 5: Salve a pasta de trabalho

Depois de trabalhar com os dados, você pode querer salvar a pasta de trabalho em um novo arquivo. Aspose.Cells torna isso fácil com um simplesSave método:

string outputDir = "Your Document Directory";
oExcelWorkBook.Save(outputDir + "outputsamplePreferredParser.xlsx");

Isso salva a pasta de trabalho como um arquivo Excel, preservando toda a formatação e análise de dados que você aplicou.

Conclusão

Abrir arquivos CSV com um analisador preferencial no Aspose.Cells para .NET é uma maneira flexível e poderosa de lidar com diferentes tipos de dados. Ao criar analisadores personalizados e configurar opções de carregamento, você pode garantir que seus arquivos CSV sejam analisados exatamente como você precisa, esteja você lidando com texto, datas ou outros formatos personalizados. Com este tutorial, você agora está equipado para lidar com cenários de análise de dados mais complexos em seus projetos.

Perguntas frequentes

Qual é o propósito dos analisadores personalizados no Aspose.Cells para .NET?

Analisadores personalizados permitem que você defina como tipos de dados específicos, como texto ou datas, devem ser analisados ao carregar um arquivo CSV.

Posso usar um caractere separador diferente no arquivo CSV?

Sim, você pode especificar qualquer caractere como separador noTxtLoadOptions.Separator propriedade.

Como lidar com a codificação no Aspose.Cells ao carregar um CSV?

Você pode definir oEncoding propriedade deTxtLoadOptions para qualquer esquema de codificação como UTF-8, ASCII, etc.

O que acontece se o formato de data no CSV for diferente?

Você pode definir o formato de data específico usando um analisador personalizado, garantindo a análise correta dos valores de data.

Posso salvar a pasta de trabalho em outros formatos?

Sim, o Aspose.Cells permite que você salve a pasta de trabalho em vários formatos, como XLSX, CSV, PDF e muito mais.

Abrindo arquivos CSV