Subsecções de Installation
System Requirements
Sheetize SDKs são projetados para se integrar perfeitamente com aplicações .NET, suportando uma variedade de sistemas operacionais e ambientes de desenvolvimento. Abaixo estão os principais requisitos do sistema:
Sistemas Operacionais Suportados
Windows
- Windows 7 (x64, x86)
- Windows 8, 8.1 (x64, x86)
- Windows 10 (x64, x86)
- Windows 11 (x64, x86)
- Windows Server 2003 até Windows Server 2022 (x64, x86)
- Microsoft Azure
macOS
- macOS 10.12 (Sierra) e posteriores
Linux
- Compatível com várias distribuições Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)
Android
- Suporta Android 8.0 (Oreo) e posteriores
Ambientes de Desenvolvimento
- Microsoft Visual Studio:
- Visual Studio 2010 e posteriores (inclusive 2019 e 2022)
- Suporta qualquer ambiente de desenvolvimento que tenha como alvo plataformas .NET
.NET Frameworks Suportados
- .NET Framework 4.0 e superior
- .NET Standard 2.0 (.NET Core 3.1+)
- .NET 6.0, .NET 7.0, .NET 8.0
Notas Adicionais
- Adobe Acrobat não é requerido para usar Sheetize SDKs, mas é recomendado para visualizar documentos de planilhas.
Declaration
SDKs Sheetize requerem um conjunto de permissões de Confiança Total quando usados em aplicações .NET. Este nível de permissão é necessário para realizar operações críticas em nível de sistema, como acessar configurações do registro, arquivos do sistema e gerenciar fontes.
Por que a Confiança Total é Necessária
Os SDKs Sheetize dependem de classes principais do sistema .NET, que muitas vezes precisam de permissões elevadas pelas seguintes razões:
- Acesso ao Registro: Algumas operações podem exigir a leitura ou escrita no registro do sistema para fins de configuração.
- Arquivos do Sistema: Tarefas como manipulação de fontes ou operações de arquivos podem precisar de acesso a arquivos do sistema além do diretório virtual da aplicação.
Limitações em Ambientes de Confiança Média
Em ambientes de hospedagem que impõem segurança de Confiança Média, várias permissões críticas são restritas ou indisponíveis, o que pode prejudicar a funcionalidade dos SDKs. As seguintes limitações se aplicam sob Confiança Média:
- OleDbPermission: Impede o uso de provedores de dados OLE DB gerenciados pelo ADO.NET para acessar bancos de dados.
- EventLogPermission: Bloqueia o acesso ao Log de Eventos do Windows, limitando capacidades de diagnóstico.
- ReflectionPermission: Restringe reflexão, afetando certas operações dinâmicas.
- RegistryPermission: Nega acesso ao registro do sistema.
- WebPermission: Limita a comunicação a endereços ou intervalos pré-definidos, conforme configurado no elemento
<trust>
. - FileIOPermission: Limita o acesso a arquivos dentro do diretório virtual da aplicação.
Para garantir total funcionalidade, os SDKs Sheetize devem ser usados em um ambiente de Confiança Total.
Non-Windows Environment
Sheetize SDKs suportam .NET Standard 2.0, permitindo que sejam usados em aplicações .NET Core que rodam em Linux ou outros ambientes que não sejam Windows. Para garantir um desempenho ideal e a renderização correta do texto, siga os passos abaixo:
Configuração Recomendada para Linux
1. Instale o Pacote libgdiplus
O pacote libgdiplus fornece funcionalidades essenciais do GDI+, críticas para a renderização e processamento de planilhas. Instale-o executando o seguinte comando em seu terminal:
sudo apt-get install libgdiplus
Para garantir a renderização correta do texto, instale as fontes TrueType da Microsoft usando:
sudo apt-get install ttf-mscorefonts-installer
Essas fontes devem estar localizadas no diretório /usr/share/fonts/truetype/msttcorefonts
. Se o seu sistema usar um diretório diferente, atualize o caminho em seu código antes de realizar quaisquer operações com Sheetize SDKs:
Sheetize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"))
Dica
Ao instalar esses pacotes e configurar corretamente o caminho das fontes, você pode maximizar o desempenho dos Sheetize SDKs no Linux ou em outros sistemas que não sejam Windows.
Evaluation
Você pode facilmente baixar os SDKs do Sheetize para fins de avaliação. A versão de avaliação é totalmente funcional, com a única diferença sendo a forma como você ativa a licença.
Limitações da Versão de Avaliação
A versão de avaliação oferece acesso total a todos os recursos, mas inclui as seguintes limitações até que uma licença seja aplicada:
- Uma marca d’água de avaliação é adicionada a toda a saída gerada.
- Apenas as quatro primeiras páginas de qualquer planilha podem ser visualizadas ou editadas.
Para remover essas limitações e desbloquear todas as capacidades do Sheetize, basta aplicar uma licença adicionando algumas linhas de código ao seu projeto.
Subsecções de Developer's Guide
HTML Converter
O Sheetize HTML Converter for .NET oferece capacidades robustas para converter documentos entre os formatos PDF e HTML, ideal para aplicações web, arquivamento e geração de relatórios. Com várias opções para manuseio de recursos e layouts, o conversor se adapta a vários requisitos de projeto.
Principais Recursos
Conversão de PDF para HTML
Converta arquivos PDF para HTML para tornar documentos acessíveis para visualização baseada na web ou integração em aplicações onde o formato HTML é preferido.
Conversão de HTML para PDF
Transforme conteúdo HTML em PDFs de alta qualidade, perfeito para gerar relatórios imprimíveis, arquivar conteúdo da web ou criar formatos de documentos compartilháveis.
Guia Detalhado
Convertendo PDF para HTML
Para converter um PDF para HTML:
- Inicializar o Conversor: Crie uma instância de
HtmlConverter
. - Definir Opções de Conversão: Use
PdfToHtmlOptions
para personalizar a saída, escolhendo recursos incorporados ou externos. - Definir Caminhos de Entrada e Saída: Defina os caminhos para seu PDF de entrada e HTML de saída.
- Executar a Conversão: Chame o método
Process
para converter o arquivo.
Exemplo: Converter PDF para HTML com Recursos Incorporados
// Passo 1: Inicializar o Conversor HTML
var converter = new HtmlConverter();
// Passo 2: Configurar opções para a conversão de PDF para HTML
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Passo 3: Definir caminhos dos arquivos
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.html"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Disponíveis para Conversão de PDF para HTML
SaveDataType:
FileWithEmbeddedResources
: Gera um único arquivo HTML com todos os recursos incorporados.FileWithExternalResources
: Salva recursos separadamente, ideal para arquivos HTML grandes.
Personalização da Saída:
BasePath
: Defina o caminho base para recursos no documento HTML.IsRenderToSinglePage
: Opcionalmente renderize todo o conteúdo PDF em uma única página HTML.
Convertendo HTML para PDF
Para converter um documento HTML para PDF, siga estas etapas:
- Inicializar o Conversor: Crie uma instância do
HtmlConverter
. - Configurar Opções de PDF: Use
HtmlToPdfOptions
para definir o layout e as configurações de mídia. - Especificar Caminhos: Defina os caminhos do arquivo HTML de entrada e do arquivo PDF de saída.
- Executar a Conversão: Execute o método
Process
para concluir a conversão.
Exemplo: Converter HTML para PDF
// Passo 1: Inicializar o Conversor HTML
var converter = new HtmlConverter();
// Passo 2: Configurar opções para a conversão de HTML para PDF
var options = new HtmlToPdfOptions();
// Passo 3: Definir caminhos dos arquivos
options.AddInput(new FileDataSource("input.html"));
options.AddOutput(new FileDataSource("output.pdf"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Adicionais para Conversão de HTML para PDF
Tipo de Mídia:
HtmlMediaType.Print
: Ideal para gerar PDFs adequados para impressão.HtmlMediaType.Screen
: Use ao converter conteúdo projetado para visualização digital.
Ajustes de Layout:
PageLayoutOption
: Ajusta como o conteúdo HTML se encaixa no layout do PDF, como ScaleToPageWidth
para garantir que o conteúdo seja dimensionado para a largura do PDF.IsRenderToSinglePage
: Permite renderizar todo o conteúdo HTML em uma única página PDF, se necessário para apresentações concisas.
Este conversor é versátil para uma variedade de aplicações, desde a geração de relatórios em PDF baseados em conteúdo da web até a conversão de arquivos de documentos PDF para acessibilidade baseada na web. Para configurações mais avançadas, consulte a documentação completa do Sheetize.
Image Converter
O Sheetize Image Converter para .NET permite que desenvolvedores convertam documentos de e para vários formatos de imagem, sendo ideal para aplicações que envolvem visualização de documentos, arquivamento de imagens e geração de conteúdo baseado em imagem.
Principais Recursos
Conversão de PDF para Imagem
Converta documentos PDF para formatos de imagem (por exemplo, PNG, JPEG), perfeito para gerar pré-visualizações ou para processamento de documentos baseados em imagem.
Conversão de Imagem para PDF
Transforme arquivos de imagem em documentos PDF, adequado para combinar imagens em um único arquivo ou criar relatórios PDF a partir de dados baseados em imagem.
Guia Detalhado
Convertendo PDF para Imagem
Para converter um documento PDF para um formato de imagem:
- Inicializar o Conversor: Crie uma instância de
ImageConverter
. - Definir Opções de Conversão: Use
PdfToImageOptions
para especificar o formato de imagem desejado, resolução e qualidade de saída. - Definir Caminhos de Entrada e Saída: Defina os caminhos para o PDF de entrada e os arquivos de imagem de saída.
- Executar a Conversão: Chame o método
Process
para completar a conversão.
Exemplo: Converter PDF para Imagem PNG
// Passo 1: Inicializar o Conversor de Imagem
var converter = new ImageConverter();
// Passo 2: Configurar opções para conversão de PDF para Imagem
var options = new PdfToImageOptions(ImageType.Png);
options.Resolution = 300; // Definir resolução para 300 DPI
options.Quality = 90; // Definir qualidade da imagem para 90%
// Passo 3: Definir caminhos de arquivo
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.png"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Disponíveis para Conversão de PDF para Imagem
- ImageType: Especifique o formato de imagem desejado (
Png
, Jpeg
, Bmp
, etc.). - Resolution: Defina a resolução (DPI) para a imagem de saída.
- Quality: Defina o nível de qualidade (para saída JPEG).
Convertendo Imagem para PDF
Para converter uma imagem em um PDF:
- Inicializar o Conversor: Crie uma instância de
ImageConverter
. - Definir Opções de Conversão: Use
ImageToPdfOptions
para personalizar o layout e a aparência do PDF resultante. - Especificar Caminhos: Defina os caminhos dos arquivos de imagem de entrada e PDF de saída.
- Executar a Conversão: Chame o método
Process
para gerar o PDF.
Exemplo: Converter Imagem PNG para PDF
// Passo 1: Inicializar o Conversor de Imagem
var converter = new ImageConverter();
// Passo 2: Configurar opções para a conversão de Imagem para PDF
var options = new ImageToPdfOptions();
options.PageLayoutOption = PageLayoutOption.Centered;
options.ImageScalingOption = ImageScalingOption.FitToPage;
// Passo 3: Definir caminhos de arquivo
options.AddInput(new FileDataSource("input.png"));
options.AddOutput(new FileDataSource("output.pdf"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Adicionais para Conversão de Imagem para PDF
- PageLayoutOption: Defina como a imagem é posicionada na página do PDF (por exemplo,
Centered
, TopLeft
). - ImageScalingOption: Controle como a imagem se ajusta na página do PDF (por exemplo,
FitToPage
, Stretch
).
Este conversor é versátil para desenvolvedores que precisam trabalhar com conteúdo de documentos baseados em imagem, seja gerando pré-visualizações de documentos de alta qualidade ou agrupando várias imagens em PDFs para fácil distribuição.
eBook Converter
O Sheetize eBook Converter para .NET permite a conversão contínua de documentos para e a partir de formatos populares de eBook, como EPUB e MOBI. É ideal para editores, bibliotecas digitais e desenvolvedores que integram funcionalidades de eBook em suas aplicações.
Principais Recursos
Conversão de PDF para EPUB
Converta facilmente arquivos PDF para o formato EPUB, otimizando-os para eReaders e outros dispositivos que suportam formatos de eBook.
Conversão de EPUB para PDF
Converta conteúdo de eBook de EPUB para PDF, tornando-o adequado para impressão ou visualização offline em um formato padronizado.
Guia Detalhado
Convertendo PDF para EPUB
Para converter um documento PDF em um eBook EPUB:
- Inicialize o Conversor: Crie uma instância de
EbookConverter
. - Defina as Opções de Conversão: Use
PdfToEpubOptions
para configurar as definições para a saída EPUB, como manipulação de imagens e metadados. - Defina os Caminhos de Entrada e Saída: Defina os caminhos para o PDF de entrada e o EPUB de saída.
- Execute a Conversão: Chame o método
Process
para converter o documento.
Exemplo: Converter PDF para EPUB
// Etapa 1: Inicialize o conversor de eBook
var converter = new EbookConverter();
// Etapa 2: Configure opções para conversão de PDF para EPUB
var options = new PdfToEpubOptions();
options.IncludeImages = true; // Incluir imagens no EPUB de saída
options.SetMetadata("Title", "eBook Convertido");
// Etapa 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.epub"));
// Etapa 4: Execute a conversão
converter.Process(options);
Opções Disponíveis para Conversão de PDF para EPUB
- IncludeImages: Especifique se deseja incluir imagens do PDF original no EPUB resultante.
- SetMetadata: Adicione metadados como título, autor e assunto ao arquivo EPUB.
Convertendo EPUB para PDF
Para converter um arquivo EPUB em PDF:
- Inicialize o Conversor: Crie uma instância de
EbookConverter
. - Configure as Opções de PDF: Use
EpubToPdfOptions
para definir configurações como layout da página e margens. - Especifique os Caminhos: Defina os caminhos do arquivo EPUB de entrada e do PDF de saída.
- Execute a Conversão: Chame o método
Process
para concluir a conversão.
Exemplo: Converter EPUB para PDF
// Etapa 1: Inicialize o conversor de eBook
var converter = new EbookConverter();
// Etapa 2: Configure opções para conversão de EPUB para PDF
var options = new EpubToPdfOptions();
options.PageLayoutOption = PageLayoutOption.Portrait;
options.Margin = new MarginSettings(10, 10, 10, 10);
// Etapa 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.epub"));
options.AddOutput(new FileDataSource("output.pdf"));
// Etapa 4: Execute a conversão
converter.Process(options);
Opções Adicionais para Conversão de EPUB para PDF
- PageLayoutOption: Defina o layout da página para o PDF resultante, como
Portrait
ou Landscape
. - MarginSettings: Defina margens para o PDF de saída.
Este conversor é extremamente útil tanto para editores quanto para desenvolvedores que precisam automatizar fluxos de trabalho relacionados a eBooks. Seja criando eBooks a partir de documentos PDF ou preparando arquivos de eBook para impressão, o Sheetize eBook Converter oferece uma solução flexível.
JSON Converter
O Sheetize JSON Converter para .NET oferece uma funcionalidade robusta para converter documentos para e de formato JSON, permitindo fácil integração em aplicações web e fluxos de trabalho de processamento de dados.
Principais Recursos
Conversão de Documento para JSON
Converta documentos (por exemplo, PDF, DOCX) para o formato JSON para extrair conteúdo em um formato estruturado para análise ou integração posterior.
Conversão de JSON para Documento
Transforme dados JSON em formatos de documento, como PDF ou DOCX, permitindo a fácil geração de relatórios ou automação de documentos.
Guia Detalhado
Convertendo Documento para JSON
Para converter um documento em JSON:
- Inicialize o Conversor: Crie uma instância de
JsonConverter
. - Defina as Opções de Conversão: Use
DocumentToJsonOptions
para configurar como o documento é representado em JSON. - Defina os Caminhos de Entrada e Saída: Defina os caminhos para o documento de entrada e o arquivo JSON de saída.
- Execute a Conversão: Chame o método
Process
para converter o documento.
Exemplo: Converter PDF para JSON
// Passo 1: Inicialize o Conversor JSON
var converter = new JsonConverter();
// Passo 2: Configure opções para conversão de Documento para JSON
var options = new DocumentToJsonOptions();
options.IncludeMetadata = true; // Incluir metadados na saída JSON
options.FormatOutput = true; // Formatar a saída JSON para legibilidade
// Passo 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.json"));
// Passo 4: Execute a conversão
converter.Process(options);
Opções Disponíveis para Conversão de Documento para JSON
- IncludeMetadata: Especifique se deseja incluir metadados do documento na saída JSON.
- FormatOutput: Escolha se deseja formatar o JSON para legibilidade.
Convertendo JSON para Documento
Para converter dados JSON em um documento:
- Inicialize o Conversor: Crie uma instância de
JsonConverter
. - Defina as Opções de Conversão: Use
JsonToDocumentOptions
para definir o formato e layout do documento de destino. - Especifique os Caminhos: Defina os caminhos do arquivo JSON de entrada e do documento de saída.
- Execute a Conversão: Chame o método
Process
para gerar o documento.
Exemplo: Converter JSON para PDF
// Passo 1: Inicialize o Conversor JSON
var converter = new JsonConverter();
// Passo 2: Configure opções para conversão de JSON para Documento
var options = new JsonToDocumentOptions(DocumentFormat.Pdf);
options.PageLayoutOption = PageLayoutOption.Portrait;
// Passo 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.json"));
options.AddOutput(new FileDataSource("output.pdf"));
// Passo 4: Execute a conversão
converter.Process(options);
Opções Adicionais para Conversão de JSON para Documento
- DocumentFormat: Especifique o formato de destino (
Pdf
, Docx
, etc.). - PageLayoutOption: Defina o layout da página para o documento resultante (
Retrato
, Paisagem
).
Este conversor oferece capacidades poderosas para integrar o conteúdo de documentos com serviços web e outras aplicações baseadas em dados. Seja extraindo dados de documentos ou gerando documentos a partir de dados estruturados, o Sheetize JSON Converter é uma solução ideal para fluxos de trabalho modernos de documentos.
PDF Converter
O Sheetize PDF Converter for .NET oferece funcionalidade avançada para converter documentos para e de formato PDF, tornando-o ideal para arquivamento, compartilhamento e garantindo formatação consistente de documentos em diferentes dispositivos.
Principais Recursos
Converta documentos de vários formatos, como DOCX, HTML e imagens, para PDF para fácil distribuição e impressão.
Converta documentos PDF em outros formatos, como DOCX, HTML e imagens, para fácil edição ou integração em outros fluxos de trabalho.
Guia Detalhado
Convertendo Documentos para PDF
Para converter um documento para PDF:
- Inicialize o Conversor: Crie uma instância de
PdfConverter
. - Defina Opções de Conversão: Use
DocumentToPdfOptions
para configurar as definições, como layout da página e compressão. - Defina Caminhos de Entrada e Saída: Configure os caminhos para o documento de entrada e o PDF de saída.
- Execute a Conversão: Chame o método
Process
para converter o documento.
Exemplo: Converter DOCX para PDF
// Etapa 1: Inicialize o Conversor PDF
var converter = new PdfConverter();
// Etapa 2: Configure opções para conversão de documento para PDF
var options = new DocumentToPdfOptions();
options.PageLayoutOption = PageLayoutOption.Portrait;
options.CompressionLevel = CompressionLevel.High;
// Etapa 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.docx"));
options.AddOutput(new FileDataSource("output.pdf"));
// Etapa 4: Execute a conversão
converter.Process(options);
Opções Disponíveis para Conversão de Documento para PDF
- PageLayoutOption: Defina o layout da página para o PDF resultante (
Portrait
, Landscape
). - CompressionLevel: Especifique o nível de compressão para reduzir o tamanho do arquivo (
Low
, Medium
, High
).
Para converter um documento PDF em outro formato:
- Inicialize o Conversor: Crie uma instância de
PdfConverter
. - Configure Opções de Conversão: Use
PdfToDocumentOptions
para especificar o formato de saída e qualquer personalização. - Especifique os Caminhos: Defina os caminhos do PDF de entrada e do arquivo de documento de saída.
- Execute a Conversão: Chame o método
Process
para concluir a conversão.
Exemplo: Converter PDF para DOCX
// Etapa 1: Inicialize o Conversor PDF
var converter = new PdfConverter();
// Etapa 2: Configure opções para conversão de PDF para DOCX
var options = new PdfToDocumentOptions(DocumentFormat.Docx);
// Etapa 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.docx"));
// Etapa 4: Execute a conversão
converter.Process(options);
- DocumentFormat: Especifique o formato de saída desejado (
Docx
, Html
, Png
, etc.). - TextExtractionMode: Defina como o texto é extraído do PDF (
PlainText
, FormattedText
).
O Sheetize PDF Converter é uma ferramenta essencial para gerenciar documentos, seja para criar arquivos PDF que podem ser compartilhados universalmente ou para converter PDFs de volta para formatos editáveis. Ele oferece flexibilidade em ambas as direções, tornando-se uma poderosa adição ao kit de ferramentas de qualquer desenvolvedor.
Spreadsheet Converter
O Sheetize Spreadsheet Converter for .NET fornece funcionalidade para converter planilhas entre diferentes formatos, tornando-o adequado para tarefas de transformação de dados, relatórios e integração.
Principais Recursos
Converter Planilha para PDF
Converta arquivos de planilha (por exemplo, XLSX, CSV) para PDF para fácil compartilhamento e impressão.
Converta planilhas para formatos como CSV, JSON ou HTML, permitindo a integração com aplicativos da web ou fluxos de trabalho de processamento de dados.
Guia Detalhado
Convertendo Planilha para PDF
Para converter uma planilha para PDF:
- Inicializar o Conversor: Crie uma instância de
SpreadsheetConverter
. - Definir Opções de Conversão: Use
SpreadsheetToPdfOptions
para configurar configurações como layout da página, opções de ajuste e marcas d’água. - Definir Caminhos de Entrada e Saída: Defina os caminhos para a planilha de entrada e o PDF de saída.
- Executar a Conversão: Chame o método
Process
para concluir a conversão.
Exemplo: Converter XLSX para PDF
// Passo 1: Inicializar o Conversor de Planilhas
var converter = new SpreadsheetConverter();
// Passo 2: Configurar opções para conversão de planilha para PDF
var options = new SpreadsheetToPdfOptions();
options.PageLayoutOption = PageLayoutOption.Landscape;
options.FitToPage = true; // Garantir que a planilha se ajuste a uma única página
// Passo 3: Definir caminhos de arquivos
options.AddInput(new FileDataSource("input.xlsx"));
options.AddOutput(new FileDataSource("output.pdf"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Disponíveis para Conversão de Planilha para PDF
- PageLayoutOption: Defina a orientação da página para o PDF resultante (
Retrato
, Paisagem
). - FitToPage: Especifique se deve ajustar o conteúdo da planilha em uma única página.
Para converter uma planilha para outro formato (por exemplo, CSV, HTML):
- Inicializar o Conversor: Crie uma instância de
SpreadsheetConverter
. - Configurar Opções de Conversão: Use
SpreadsheetToDocumentOptions
para especificar o formato de destino. - Especificar Caminhos: Defina os caminhos da planilha de entrada e do arquivo de saída.
- Executar a Conversão: Chame o método
Process
para gerar a saída.
Exemplo: Converter XLSX para CSV
// Passo 1: Inicializar o Conversor de Planilhas
var converter = new SpreadsheetConverter();
// Passo 2: Configurar opções para conversão de planilha para CSV
var options = new SpreadsheetToDocumentOptions(DocumentFormat.Csv);
// Passo 3: Definir caminhos de arquivos
options.AddInput(new FileDataSource("input.xlsx"));
options.AddOutput(new FileDataSource("output.csv"));
// Passo 4: Executar a conversão
converter.Process(options);
Opções Adicionais para Conversão de Planilha para Documento
- DocumentFormat: Defina o formato de saída desejado (
Csv
, Json
, Html
). - IncludeFormulas: Escolha se deseja incluir fórmulas calculadas ou apenas valores estáticos na saída.
O Sheetize Spreadsheet Converter é altamente versátil, oferecendo suporte para transformar planilhas em vários formatos para acomodar diferentes necessidades. Quer você esteja criando relatórios em PDF a partir de planilhas ou extraindo dados para processamento, este conversor oferece uma solução confiável para desenvolvedores.
Spreadsheet Merger
O Sheetize Spreadsheet Merger para .NET permite que os desenvolvedores unam vários arquivos de planilhas em um único, ideal para consolidar dados de diferentes fontes em um relatório unificado.
Principais Recursos
Mesclar Múltiplas Planilhas
Combine várias planilhas em um único arquivo, preservando a integridade dos dados e a formatação.
Guia Detalhado
Mesclando Planilhas
Para mesclar várias planilhas em uma:
- Inicializar o Merger: Crie uma instância de
SpreadsheetMerger
. - Adicionar Arquivos de Entrada: Adicione todas as planilhas a serem mescladas.
- Especificar o Caminho de Saída: Defina o caminho do arquivo de saída para a planilha mesclada.
- Executar a Mesclagem: Chame o método
Process
para mesclar os arquivos.
Exemplo: Mesclar Múltiplos Arquivos XLSX
// Passo 1: Inicializar o Spreadsheet Merger
var merger = new SpreadsheetMerger();
// Passo 2: Adicionar arquivos de entrada
merger.AddInput(new FileDataSource("input1.xlsx"));
merger.AddInput(new FileDataSource("input2.xlsx"));
// Passo 3: Definir o caminho do arquivo de saída
merger.AddOutput(new FileDataSource("merged_output.xlsx"));
// Passo 4: Executar o processo de mesclagem
merger.Process();
Essa funcionalidade é especialmente útil para criar relatórios unificados ou consolidar dados de várias fontes sem intervenção manual.
Spreadsheet Splitter
O Sheetize Spreadsheet Splitter para .NET ajuda os desenvolvedores a dividir grandes arquivos de planilhas em partes menores, ideal para distribuição e gerenciamento de dados.
Principais Funcionalidades
Dividir Planilhas em Arquivos Menores
Divida grandes arquivos de planilhas por aba, intervalo ou regras personalizadas para facilitar o manuseio e o compartilhamento.
Guia Detalhado
Dividindo uma Planilha
Para dividir uma planilha em múltiplos arquivos menores:
- Inicialize o Divisor: Crie uma instância de
SpreadsheetSplitter
. - Defina os Critérios de Divisão: Use
SplitterOptions
para especificar como dividir (por exemplo, por aba ou por contagem de linhas). - Defina os Caminhos de Entrada e Saída: Configure o arquivo de entrada e os caminhos para os arquivos divididos de saída.
- Execute a Divisão: Chame o método
Process
para dividir o arquivo.
Exemplo: Dividir XLSX por Aba
// Passo 1: Inicialize o Spreadsheet Splitter
var splitter = new SpreadsheetSplitter();
// Passo 2: Configure as opções para divisão por aba
var options = new SplitterOptions(SplitMode.BySheet);
// Passo 3: Defina os caminhos dos arquivos
options.AddInput(new FileDataSource("input.xlsx"));
options.AddOutput(new FileDataSource("output_directory"));
// Passo 4: Execute o processo de divisão
splitter.Process(options);
Esta ferramenta é perfeita para dividir grandes arquivos em partes menores e gerenciáveis, tornando os dados mais acessíveis e mais fáceis de trabalhar.
Spreadsheet Unlocker
O Sheetize Spreadsheet Unlocker para .NET oferece a capacidade de remover a proteção de planilhas, permitindo que os desenvolvedores editem ou reformatem conteúdo bloqueado.
Principais Recursos
Desbloquear Planilhas Protegidas
Remova a proteção por senha ou o bloqueio em nível de planilha para permitir modificações na planilha.
Guia Detalhado
Desbloqueando uma Planilha Protegida
Para desbloquear uma planilha protegida:
- Inicializar o Desbloqueador: Crie uma instância de
SpreadsheetUnlocker
. - Fornecer Credenciais de Desbloqueio: Defina a senha ou especifique outros parâmetros de desbloqueio.
- Definir Caminhos de Entrada e Saída: Defina os caminhos para o arquivo bloqueado de entrada e o arquivo desbloqueado de saída.
- Executar o Desbloqueio: Chame o método
Process
para desbloquear o arquivo.
Exemplo: Desbloquear um Arquivo XLSX
// Passo 1: Inicializar o Spreadsheet Unlocker
var unlocker = new SpreadsheetUnlocker();
// Passo 2: Definir credenciais de desbloqueio
var options = new UnlockerLoadOptions();
options.Password = "password123";
// Passo 3: Definir caminhos de arquivo
options.AddInput(new FileDataSource("locked_input.xlsx"));
options.AddOutput(new FileDataSource("unlocked_output.xlsx"));
// Passo 4: Executar o processo de desbloqueio
unlocker.Process(options);
O Spreadsheet Unlocker é útil para desenvolvedores que precisam modificar programaticamente planilhas protegidas.
Text Converter
O Sheetize Text Converter para .NET permite a conversão de documentos para e de formato de texto simples, ideal para extração de dados, arquivamento e integração com sistemas baseados em texto.
Principais Recursos
Converter Documentos para Texto Simples
Extraia conteúdo de texto de documentos como PDF, DOCX e HTML, útil para processamento de dados e arquivamento.
Converter Texto Simples para Formatos de Documento
Crie documentos formatados a partir de texto simples, fornecendo uma maneira fácil de gerar relatórios ou arquivos estruturados.
Guia Detalhado
Convertendo Documento para Texto Simples
Para converter um documento para texto simples:
- Inicializar o Conversor: Crie uma instância de
TextConverter
. - Definir Opções de Conversão: Use
DocumentToTextOptions
para configurar as configurações de saída. - Definir Caminhos de Entrada e Saída: Defina os caminhos para o documento de entrada e o arquivo de texto de saída.
- Executar a Conversão: Chame o método
Process
para converter o documento.
Exemplo: Converter PDF para Texto Simples
// Etapa 1: Inicializar o Text Converter
var converter = new TextConverter();
// Etapa 2: Configurar opções para conversão de documento para texto
var options = new DocumentToTextOptions();
// Etapa 3: Definir caminhos de arquivo
options.AddInput(new FileDataSource("input.pdf"));
options.AddOutput(new FileDataSource("output.txt"));
// Etapa 4: Executar a conversão
converter.Process(options);
O Text Converter é essencial para cenários em que a extração de texto é necessária, como criar arquivos de arquivamento ou processar dados em texto simples.
FAQs
Este FAQ fornece informações detalhadas sobre os recursos e funcionalidades do Sheetize .NET SDKs, cobrindo aspectos como conversão de planilhas, gerenciamento de documentos e detalhes de compatibilidade.
Perguntas Gerais
1. O que é o Sheetize para .NET?
Sheetize para .NET é um SDK poderoso projetado para gerenciar documentos de planilhas programaticamente. Ele inclui ferramentas para converter planilhas em vários formatos, editar dados de células, lidar com formulários de planilhas e otimizar fluxos de trabalho de documentos.
2. Como instalo os SDKs do Sheetize para .NET?
Você pode instalar os SDKs do Sheetize baixando arquivos de assembly do site oficial ou buscando pacotes diretamente do NuGet. Instruções detalhadas de instalação estão disponíveis na documentação de cada SDK.
Conversão de Planilhas
3. Como posso converter uma planilha para PDF?
Para converter uma planilha para o formato PDF usando o Conversor de Planilhas para PDF:
- Instancie a classe
SpreadsheetPdfConverter
. - Crie um objeto
PdfConversionOptions
para configurar as configurações de conversão. - Especifique os caminhos do arquivo da planilha de entrada e do PDF de saída.
- Chame o método
Convert
para executar a conversão.
4. Como faço para converter planilhas para HTML?
Usando o Conversor de Planilhas para HTML:
- Crie uma instância da classe
HtmlConverter
. - Configure opções (por exemplo, configurações de design responsivo) via
HtmlConversionOptions
. - Especifique os caminhos dos arquivos de entrada/saída e chame o método
Convert
.
5. Como faço para converter uma planilha para CSV?
Para converter uma planilha para CSV:
- Instancie a classe
CsvConverter
e crie um objeto CsvConversionOptions
. - Adicione o arquivo da planilha de entrada e especifique a pasta de saída.
- Defina opções como o tipo de delimitador.
- Chame o método
Convert
para gerar o arquivo CSV.
Gerenciamento de Documentos
6. Como faço para mesclar várias planilhas em uma?
Para mesclar planilhas usando o Mesclador de Planilhas:
- Instancie a classe
SpreadsheetMerger
. - Adicione os arquivos das planilhas de entrada e especifique um arquivo de saída através de
MergeOptions
. - Chame o método
Merge
para combinar os arquivos.
7. Como posso dividir uma planilha grande?
Usando o Divisor de Planilhas:
- Instancie a classe
SpreadsheetSplitter
. - Configure as definições de divisão com
SplitOptions
para definir como dividir o arquivo. - Adicione a planilha de entrada e especifique a pasta de saída.
- Chame o método
Split
para criar seções menores da planilha.
8. Como faço para desbloquear uma planilha protegida?
Para desbloquear uma planilha programaticamente:
- Crie uma instância da classe
SpreadsheetUnlocker
. - Use
UnlockOptions
para fornecer detalhes da senha. - Adicione o arquivo de entrada e especifique um caminho de saída.
- Chame o método
Unlock
para remover a proteção.
SDKs de Conversão Especializada
11. Como posso converter uma planilha para JSON?
Para converter planilhas para JSON:
- Instancie a classe
JsonConverter
. - Use
JsonConversionOptions
para configurar os caminhos de entrada/saída e as configurações. - Chame o método
Convert
para produzir o arquivo JSON.
12. Como faço para converter uma planilha em imagens (por exemplo, JPEG, PNG)?
Usando o Conversor de Planilhas para Imagem:
- Crie uma instância da classe
ImageConverter
. - Configure as definições de imagem via
ImageConversionOptions
(por exemplo, tipo de formato, resolução). - Adicione os caminhos dos arquivos de entrada/saída e chame o método
Convert
.
Licenciamento e Compatibilidade
13. Quais são os requisitos do sistema para usar os SDKs do Sheetize?
Sheetize suporta:
- Sistemas Operacionais: Windows 7-11, Windows Server 2008-2022, macOS (10.14+), e Linux.
- Frameworks: .NET Framework 4.0 a 8.0.
- IDE: Compatível com várias versões do Visual Studio.
14. Como eu defino chaves de licença para os SDKs do Sheetize?
Para ativar um SDK, referencie Sheetize em seu projeto e defina as chaves de licença antes de usar quaisquer métodos. Instruções detalhadas estão disponíveis na documentação de cada SDK.
15. Onde posso encontrar mais exemplos e documentação para o Sheetize?
Documentação completa da API e exemplos estão disponíveis no site do Sheetize, ou através dos pacotes NuGet dentro do seu ambiente de desenvolvimento.
Recursos Adicionais
Embora o Sheetize se concentre principalmente na manipulação de planilhas, ele também suporta conversões para e de formatos como JSON, HTML, PDF e formatos de imagem como JPEG e PNG.
Você pode converter planilhas em documentos do Word usando o Conversor de Planilhas para Word da seguinte maneira:
- Crie uma instância da classe
SpreadsheetWordConverter
. - Configure opções com
DocConversionOptions
. - Adicione os caminhos de entrada/saída e chame o método
Convert
.
Para mais informações, visite o site oficial.