Dividir um documento
Splitting ou split um documento é o processo de quebrar um grande documento em um maior número de arquivos menores. Existem várias razões para dividir um arquivo. Por exemplo, você só precisa de algumas páginas de um documento específico e não de todo. Ou por razões de privacidade, você quer 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 fazer as ações necessárias com eles, por exemplo, para marcar, salvar ou enviar.
Aspose.Words fornece-lhe 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 por 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 estes passos:
- Carregar o documento em qualquer formato suportado.
- Dividir o documento.
- Salve os documentos de saída.
Depois de dividir um documento, você será capaz de abrir todos os documentos de saída que começarão com as páginas necessárias, texto, etc.
Experimente online
Você pode tentar esta funcionalidade com a nossa Divisor de documento online gratuito.
Dividir um documento usando critérios diferentes
Aspose.Words permite que você dividir EPUB ou documentos 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 o DocumentSplitCriteria enumeração. Então você pode dividir um documento em capítulos usando um dos seguintes critérios ou combinar mais de um critério juntos:
- parágrafo da rubrica,
- quebra de secção,
- quebra de coluna,
- quebra de página.
Ao salvar a saída para HTML, Aspose.Words salvar 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 para EPUB, Aspose.Words salvar o resultado em um único arquivo EPUB independentemente do DocumentSplitCriteria valor que usaste. Assim, usando DocumentSplitCriteria para documentos EPUB apenas afeta o aparecimento de seu conteúdo em aplicativos de leitores: o conteúdo será dividido em capítulos e o documento não aparecerá mais contínuo.
Nesta seção, consideramos apenas alguns dos possíveis critérios de divisão.
Dividir um documento por Categoria
Para dividir um documento em capítulos por títulos, use o HeadingParagraph valor do DocumentSplitCriteria propriedade.
Se você precisar dividir um documento por um nível específico de parágrafos da posição, como as posições 1, 2 e 3, use também o DocumentSplitHeadingLevel propriedade. A saída será dividida por parágrafos formatados com o nível de cabeçalho especificado.
O exemplo de código a seguir mostra como dividir um documento em partes menores pelo cabeçalho:
Por favor, note que para este critério, Aspose.Words somente suporta salvar ao formato HTML quando se dividir.
Ao salvar para EPUB, o documento não é dividido em vários arquivos, e haverá apenas um arquivo de saída.
Dividir um documento por seções
Aspose.Words também permite que você use quebras de seção para dividir documentos e salvá-los em HTML. Com esta finalidade, use SectionBreak como o DocumentSplitCriteria:
Há 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 por Aspose.Words.
O exemplo de código a seguir mostra como dividir um documento em partes menores por quebras de seção (sem usar o DocumentSplitCriteria propriedade):
Dividir por Páginas
Você também pode dividir uma página de documento por página, por intervalos de página, ou começando com os números de página especificados. Neste caso, ExtractPages método pode fazer o trabalho.
Esta seção descreve vários casos de uso de documentos de divisão por página usando Document classe e a ExtractPages método.
Dividir uma página de documentos por página
Aspose.Words permite dividir uma página de documento multi-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 multi-página 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. Note que você pode escolher o intervalo de página de acordo com o número máximo e mínimo de página de um documento.
O exemplo de código a seguir mostra como dividir um documento em partes menores por faixa de página com índices de início e fim específicos:
Opção de retorno de chamada para salvar um documento
Você pode usar o DocumentPartSavingCallback propriedade para controlar como Aspose.Words salva as peças do documento quando este documento é exportado para o formato HTML. Esta propriedade permite que você renomeie arquivos de saída ou até mesmo redireciona-los para fluxos personalizados.
Por favor, note que esta chamada não é útil ao salvar para EPUB porque todas as peças de saída devem ser salvas em um único recipiente – o arquivo .epub. Assim, redirecionamento de fluxo não é suportado, e o efeito de renomeação não é visível uma vez que os arquivos são renomeados dentro do recipiente.
Mesclar o documento dividido com outro documento
Aspose.Words permite que você mesclar o documento de divisão de saída com outro documento para formar um novo documento. Isso pode ser chamado de fusão de documentos.
O exemplo de código a seguir mostra como mesclar um documento dividido com outro documento: