Serializar e trabalhar com um documento em um banco de dados
Uma das tarefas que você pode precisar realizar ao trabalhar com documentos é armazenar e recuperar objetos Document de e para um banco de dados. Por exemplo, isso seria necessário se você estivesse implementando qualquer tipo de sistema de gerenciamento de conteúdo. Todas as versões anteriores dos documentos devem ser armazenadas no sistema de banco de dados. A capacidade de armazenar documentos no banco de dados também é extremamente útil quando seu aplicativo fornece um serviço baseado na web.
Aspose.Words oferece a capacidade de converter um documento em uma matriz de bytes para trabalho posterior com esse documento em um banco de dados.
Converter um documento em matriz de bytes
Para armazenar um documento em um banco de dados ou preparar um documento para transmissão pela web, muitas vezes é necessário serializar o documento para obter uma matriz de bytes.
Para serializar um objeto Document em Aspose.Words:
- Salve-o em um MemoryStream usando a sobrecarga do método Save da classe Document.
- Chame o método ToArray, que retorna uma matriz de bytes que representa o documento em formato de byte.
As etapas acima podem ser revertidas para carregar os bytes de volta em um objeto Document.
O exemplo abaixo mostra como serializar um objeto Document para obter uma matriz de bytes e, em seguida, como desserializar a matriz de bytes para obter um objeto Document novamente:
Você pode baixar o arquivo de modelo deste exemplo em Aspose.Words GitHub.
Armazenar, ler e excluir um documento em um banco de dados
Esta seção mostra como salvar um documento em um banco de dados e depois carregá-lo de volta em um objeto Document
para trabalhar com ele. Para simplificar, o nome do arquivo é a chave usada para armazenar e buscar documentos do banco de dados. O banco de dados contém duas colunas. A primeira coluna “FileName” é armazenada como uma String e é usada para identificar documentos. A segunda coluna “FileContent” é armazenada como um objeto BLOB
que armazena o objeto do documento na forma de byte.
O exemplo de código a seguir mostra como configurar uma conexão com um banco de dados e executar comandos:
O exemplo de código a seguir mostra como salvar um documento no banco de dados, depois ler o mesmo documento novamente e, por fim, excluir o registro que contém o documento do banco de dados:
Salvar um documento em um banco de dados
Para salvar um documento em um banco de dados converta este documento em um array de bytes, conforme descrito no início deste artigo. Em seguida, salve esta matriz de bytes em um campo do banco de dados.
O exemplo de código a seguir mostra como salvar um documento no banco de dados especificado:
Especifique commandString, que é uma expressão SQL que faz todo o trabalho:
- Para salvar um documento no banco de dados, é utilizado o comando “INSERT INTO” e uma tabela especificada junto com os valores de dois campos de registro – FileName e FileContent. Para evitar parâmetros adicionais, o nome do arquivo é retirado do próprio objeto Document. O valor do campo
FileContent
recebe bytes do fluxo de memória, que contém uma representação binária do documento armazenado. - A linha restante do código executa o comando que armazena o documento Aspose.Words no banco de dados.
Recuperar um documento de um banco de dados
Para recuperar um documento do banco de dados, selecione o registro que contém os dados do documento como uma matriz de bytes. Em seguida, carregue a matriz de bytes do registro no MemoryStream e crie um objeto Document que carregará o documento do MemoryStream.
O exemplo de código a seguir mostra como recuperar e retornar um documento do banco de dados especificado usando o nome do arquivo como chave para buscar esse documento:
Excluir um documento de um banco de dados
Para excluir um documento do banco de dados, use o comando SQL apropriado sem qualquer manipulação no objeto Document.
O exemplo de código a seguir mostra como excluir um documento do banco de dados, usando o nome do arquivo para buscar o registro: