Como mesclar vários arquivos xlsm

Sheetize XLSM Merger para .NET oferece uma API simples, porém poderosa, para combinar diversas pastas de trabalho XLSM em um único arquivo, preservando todas as planilhas, macros, gráficos e formatações. Isso é útil quando você precisa consolidar relatórios, agregar dados ou criar uma pasta de trabalho mestra a partir de várias fontes.

Principais Recursos

Mesclar Vários Arquivos XLSM

Combine um número arbitrário de pastas de trabalho XLSM em um único arquivo consolidado. Todas as macros (VBA) são mantidas e permanecem funcionais no arquivo resultante.

Preservar Formatação e Objetos

Todos os estilos de célula, fórmulas, tabelas, gráficos, imagens e objetos incorporados são mantidos intactos durante o processo de mesclagem.

Suporte a Streaming

Processa pastas de trabalho grandes de forma streaming para manter o uso de memória baixo, ideal para mesclar em lote muitos arquivos.

Instruções Detalhadas

Fluxo de Trabalho para Mesclagem de XLSM

Para mesclar vários arquivos XLSM com o Sheetize, siga estas etapas:

  1. Inicializar o Merger: Crie uma instância de SpreadsheetMerger.
  2. Configurar Opções: Defina SaveOptions caso precise controlar o nome das planilhas, resolução de conflitos ou tratamento de macros.
  3. Definir Caminhos de Arquivo: Forneça a lista de arquivos XLSM de origem e o local de destino do XLSM mesclado.
  4. Executar a Mesclagem: Chame Process com as opções preparadas.

Exemplo – Mesclar três arquivos XLSM em uma única pasta de trabalho

using Sheetize;

var loadOptions = new LoadOptions();
var saveOptions = new SaveOptions
{
    OutputFile = "E:\\MergedReport.xlsm"
};

SpreadsheetMerger.Process(loadOptions, saveOptions, new string[]
{
    "Quarter1_Report.xlsm",
    "Quarter2_Report.xlsm",
    "Quarter3_Report.xlsm"
});

Dicas para Mesclagens Bem‑Sucedidas

  • Referências Consistentes de Macro: Garanta que as macros nos arquivos fonte não utilizem nomes de módulo duplicados; o Sheetize renomeará automaticamente módulos em conflito.
  • Conflitos de Nome de Planilha: Por padrão, nomes de planilhas duplicados recebem sufixos “_1”, “_2”, etc. Você pode sobrescrever esse comportamento via MergerOptions.
  • Pastas de Trabalho Grandes: Use a API de streaming (SpreadsheetMerger.StreamProcess) para manter o consumo de memória baixo ao mesclar dezenas de arquivos XLSM volumosos.

Suporte Expandido a Formatos

  • O mesmo merger pode lidar com arquivos XLSX, CSV e TSV; entretanto, apenas entradas XLSM mantêm a funcionalidade de macros.
  • Após a mesclagem, é possível aplicar proteção por senha (veja o guia de senhas para XLSX) para garantir a segurança da pasta de trabalho combinada.

Com esses recursos, o Sheetize torna a mesclagem de múltiplos arquivos XLSM simples, seja para um script rápido de relatórios ad‑hoc ou para um serviço em produção que consolida milhares de pastas de trabalho habilitadas para macro diariamente.

 Português