Dividir um documento

Splitting ou dividir um documento é o processo de dividir um documento grande em um número maior de arquivos menores. Existem vários motivos para dividir um arquivo. Por exemplo, você só precisa de algumas páginas de um documento específico e não do documento inteiro. Ou, por motivos de privacidade, você deseja compartilhar apenas algumas partes de um documento com outras pessoas. Com o recurso de divisão, você pode obter apenas as partes necessárias do documento e realizar as ações necessárias com elas, por exemplo, marcar, salvar ou enviar.

Aspose.Words oferece uma maneira eficiente de dividir um documento em vários documentos por títulos ou seções. Você também pode dividir um documento por páginas ou intervalos de páginas. Ambas as opções de divisão serão descritas neste artigo.

Para dividir um documento em arquivos menores usando Aspose.Words, você precisa seguir estas etapas:

  1. Carregue o documento em qualquer formato compatível.
  2. Divida o documento.
  3. Salve os documentos de saída.

Depois de dividir um documento, você poderá abrir todos os documentos de saída que começarão com as páginas, texto, etc. necessários.

Dividir um documento usando diferentes critérios

Aspose.Words permite dividir documentos EPUB ou HTML em capítulos de acordo com vários critérios. No processo, o estilo e o layout do documento de origem são preservados para os documentos de saída.

Você pode especificar critérios usando a enumeração DocumentSplitCriteria. Portanto, você pode dividir um documento em capítulos usando um dos seguintes critérios ou combinar mais de um critério:

  • parágrafo de título,
  • quebra de seção,
  • quebra de coluna,
  • quebra de página.

Ao salvar a saída em HTML, o Aspose.Words salva cada capítulo individual como um arquivo HTML separado. Como resultado, o documento será dividido em vários arquivos HTML. Ao salvar a saída em EPUB, o Aspose.Words salva o resultado em um único arquivo EPUB, independentemente do valor DocumentSplitCriteria usado. Portanto, o uso de DocumentSplitCriteria para documentos EPUB afeta apenas a aparência de seu conteúdo nos aplicativos de leitura: o conteúdo será dividido em capítulos e o documento não parecerá mais contínuo.

Nesta seção, consideramos apenas alguns dos possíveis critérios de divisão.

Dividir um documento por títulos

Para dividir um documento em capítulos por títulos, use o valor HeadingParagraph da propriedade DocumentSplitCriteria.

Se você precisar dividir um documento por um nível específico de parágrafos de título, como títulos 1, 2 e 3, use também a propriedade DocumentSplitHeadingLevel. A saída será dividida por parágrafos formatados com o nível de título especificado.

O exemplo de código a seguir mostra como dividir um documento em partes menores por título:

Observe que, para este critério, Aspose.Words só suporta salvar no formato HTML durante a divisão.

Ao salvar em EPUB, o documento não será dividido em vários arquivos e haverá apenas um arquivo de saída.

Dividir um documento por seções

Aspose.Words também permite usar quebras de seção para dividir documentos e salvá-los em HTML. Para isso, use SectionBreak como DocumentSplitCriteria:

Existe outra maneira de dividir o documento de origem em vários documentos de saída e você pode escolher qualquer formato de saída suportado pelo Aspose.Words.

O exemplo de código a seguir mostra como dividir um documento em partes menores por quebras de seção (sem usar a propriedade DocumentSplitCriteria):

Dividir por páginas

Você também pode dividir um documento página por página, por intervalos de páginas ou começando com os números de página especificados. Nesse caso, o método ExtractPages pode fazer o trabalho.

Esta seção descreve vários casos de uso de divisão de documentos por paginação usando a classe Document e o método ExtractPages.

Dividir uma página de documento por página

Aspose.Words permite dividir um documento de várias páginas página por página.

O exemplo de código a seguir mostra como dividir um documento e salvar cada página como um documento separado:

Dividir um documento por intervalos de páginas

Aspose.Words permite dividir um documento de várias páginas por intervalos de páginas. Você pode dividir um arquivo em vários arquivos com vários intervalos de páginas ou apenas selecionar um intervalo e salvar apenas esta parte do documento de origem. Observe que você pode escolher o intervalo de páginas de acordo com o número máximo e mínimo de páginas de um documento.

O exemplo de código a seguir mostra como dividir um documento em partes menores por intervalo de páginas com índices iniciais e finais específicos:

Opção de retorno de chamada para salvar um documento

Você pode usar a propriedade DocumentPartSavingCallback para controlar como o Aspose.Words salva partes do documento quando este documento é exportado para o formato HTML. Esta propriedade permite renomear arquivos de saída ou até mesmo redirecioná-los para fluxos personalizados.

Observe que esse retorno de chamada não é útil ao salvar em EPUB porque todas as partes de saída devem ser salvas em um único contêiner – o arquivo .epub. Portanto, o redirecionamento de fluxo não é suportado e o efeito da renomeação não é visível, pois os arquivos são renomeados dentro do contêiner.

Mesclar o documento dividido com outro documento

Aspose.Words permite mesclar o documento dividido de saída com outro documento para formar um novo documento. Isso pode ser chamado de mesclagem de documentos.

O exemplo de código a seguir mostra como mesclar um documento dividido com outro documento:

Inserir e anexar documentos em C# Localizar e substituir em C#