Readme_pt-br.md

See the documentation in English by clicking here.

SheetHelper

Biblioteca rápida e leve para fácil leitura e conversão de grandes arquivos Excel.

RECURSOS DISPONÍVEIS:
✔ Compatível com leitura de arquivos .xlsx, .xlsm, .xls, .xlsb, .csv, .txt, .rpt e outros;
✔ Obtenha um DataTable de uma planilha usando o método GetDataTable;
✔ Use SaveDataTable para salvar um DataTable em diferentes formatos e com restrição de colunas e linhas;
✔ Use o método CloseExcel para fechar todos os processos do Excel, inclusive os em segundo plano;
✔ Use GetIndexColumn para obter o índice da coluna fornecendo o nome (por exemplo, "AB");
✔ O método GetNameColumn pode ser usado para obter o nome da coluna;
✔ Use GetRowArray para obter uma linha de um DataTable;
✔ Converta um array em uma DataRow usando o método ConvertToDataRow;
✔ Converta uma planilha para diferentes formatos usando o método Converter;
✔ Permite converter intervalos de linhas. Ex: "1:23, -34:56, 70:40, 75, -1";
✔ Possibilidade de converter intervalos de colunas. Ex: "A:H, 4:9, 4:-9, B, 75, -2";
✔ Substitui o arquivo se já convertido;
✔ Opção de escolher a planilha desejada para conversão usando índice ou nome (sem diferenciação entre maiúsculas e minúsculas);
✔ Pode escolher o formato de arquivo a ser convertido;
✔ Opção de escolher o nome do arquivo, local de destino e formato a ser salvo;
✔ Permite alterar o delimitador;
✔ Suporta a conversão de colunas, linhas e planilhas ocultas;
✔ Possibilidade de escolher colunas e linhas específicas para conversão;
✔ Permite acompanhar a porcentagem de conclusão por meio da propriedade Progress;
✔ Lida com o usuário final quando o arquivo não é encontrado com MessageBox para NetFramework;
✔ Suporta descompactação de arquivos .GZ (usando UnGZ) e .ZIP (usando UnZIP). Ou use UnzipAuto para descompactar automaticamente.

Utiliza a biblioteca ExcelDataReader para realizar a leitura.

CONTATO:

https://bit.ly/FeedbackHappyHelper

PRINCIPAIS CONVERSÕES POSSÍVEIS:

INSTALAÇÃO:

 dotnet add package SheetHelper

EXEMPLO DE USO:

using SH;

namespace App
{
    static class Program
    {
        static void Main()
        {
            string origem  = "C:\\Users\\Diego\\Files\\Report.xlsx.gz";
            string destino = "C:\\Users\\Diego\\Files\\Report.csv";

            string aba = "1"; // Use "1" para a primeira aba (possível informar índice ou nome)
            string delimitador  = ";";
            string colunas  = "A, 3, b, 12:-1"; // ou null para converter todas as colunas ou "A:BC" para um intervalo de colunas
            string linhas = ":4, -2"; // Ex: Extrai da 1ª à 4ª linha e também a penúltima linha            

            bool resultado = SheetHelper.Converter(origem, destino, aba, delimitador, colunas, linhas);
            
            Console.WriteLine(resultado ? "O arquivo foi convertido com sucesso!" : "Falha ao converter o arquivo!")
        }
    }
}