Сериализиране и работа с документ в база данни

Една от задачите, които може да се наложи да изпълните, когато работите с документи се съхранява и извлича Document обекти към и от база данни. Например, това би било необходимо, ако се прилага всякакъв вид система за управление на съдържанието. Всички предишни версии на документите трябва да бъдат съхранявани в системата от данни. Възможността за съхранение на документи в базата данни също е изключително полезна, когато вашето приложение предоставя уеб-базирана услуга.

Aspose.Words осигурява възможност за преобразуване на документ в байт масив за последваща работа с този документ в база данни.

Преобразуване на документ в байт станция

За да се съхранява документ в база данни или да се подготви документ за предаване в мрежата, често е необходимо да се сериализира документът, за да се получи байт масив.

Серийна Document обект в Aspose.Words:

1. Запази го за MemoryStream с помощта на Save претоварване на метода Document Клас.
2. Обади се на ToArray метод, който връща масив от байтове, представящи документа в байт форма.

Стъпките по-горе след това могат да бъдат обърнати, за да се заредят байтите обратно в a Document Възразявам.

Избраният формат за запис е важен, за да се гарантира, че най-високата вярност се запазва при запис и повторно зареждане в Document Възразявам. Поради тази причина се предлага да се използва серия от OOXML файлови формати.

Примерът по- долу показва как да серийна Document обект, за да получите байт масив, и след това как да се десериализират байт масива, за да получите a Document Възразявам отново:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// Load the document from disk.
Document doc = new Document(dataDir + "Test File (doc).doc");

// Create a new memory stream.
MemoryStream outStream = new MemoryStream();
// Save the document to stream.
doc.Save(outStream, SaveFormat.Docx);

// Convert the document to byte form.
byte[] docBytes = outStream.ToArray();

// The bytes are now ready to be stored/transmitted.

// Now reverse the steps to load the bytes back into a document object.
MemoryStream inStream = new MemoryStream(docBytes);

// Load the stream into a new document object.
Document loadDoc = new Document(inStream);

Можете да изтеглите шаблонния файл на този пример от Aspose.Words GitHub.

Съхраняване, четене и изтриване на документ в база данни

Този раздел показва как да запишете документ в база данни и след това да го заредите обратно в Document Възразявам да работя с него. За простота, името на файла е ключът, който се използва за съхранение и извличане на документи от базата данни. Базата данни съдържа две колони. Първата колона по FileName е съхранена като низ и се използва за идентифициране на документи. Втората колона е съхранена като BLOB обект, който съхранява документа обект в байт форма.

Следният пример за код показва как да се създаде връзка към база данни и да се изпълняват команди:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
string dbName = "";
// Open a database connection.
string connString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + RunExamples.GetDataDir_Database() + dbName;
OleDbConnection mConnection = new OleDbConnection(connString);
mConnection.Open();

В този пример ние използваме Microsoft Достъп. mdb база данни за съхранение на Aspose.Words документ.

Следният пример за код показва как да се запише документ в базата данни, след това да се прочете отново същия документ и накрая да се изтрие записът, съдържащ документа от базата данни:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// Store the document to the database.
StoreToDatabase(doc, mConnection);
// Read the document from the database and store the file to disk.
Document dbDoc = ReadFromDatabase(fileName, mConnection);

// Save the retrieved document to disk.
string newFileName = Path.GetFileNameWithoutExtension(fileName) + " from DB" + Path.GetExtension(fileName);
dbDoc.Save(dataDir + newFileName);

// Delete the document from the database.
DeleteFromDatabase(fileName, mConnection);

// Close the connection to the database.
mConnection.Close();

Запис на документ в база данни

За да запазите документ в база данни конвертирайте този документ в масив от байтове, както е описано в началото на тази статия. След това, запазете този байт масив в база данни поле.

Следният пример с код показва как да се запише документ в посочената база данни:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
public static void StoreToDatabase(Document doc, OleDbConnection mConnection)
{
    // Save the document to a MemoryStream object.
    MemoryStream stream = new MemoryStream();
    doc.Save(stream, SaveFormat.Docx);

    // Get the filename from the document.
    string fileName = Path.GetFileName(doc.OriginalFileName);

    // Create the SQL command.
    string commandString = "INSERT INTO Documents (FileName, FileContent) VALUES('" + fileName + "', @Docx)";
    OleDbCommand command = new OleDbCommand(commandString, mConnection);

    // Add the @Docx parameter.
    command.Parameters.AddWithValue("Docx", stream.ToArray());

    // Write the document to the database.
    command.ExecuteNonQuery(); 
}

Посочете команда String, което е SQL израз, който върши цялата работа:

• За да запазите документ в базата данни, се използва командата по NISTERT. За да се избегнат допълнителни параметри, името на файла е взето от Document Самият обект. На FileContent Стойността на полето се присвоява от потока памет, който съдържа двоично представяне на съхранявания документ.
• Оставащият ред на кода изпълнява командата, която съхранява Aspose.Words документ в базата данни.

Изтегляне на документ от база данни

За да изтеглите документ от базата данни, изберете запис, който съдържа данните на документа като масив от байтове. След това заредете байт масива от запис в MemoryStream и създаване на Document обект, който ще зареди документа от MemoryStream.

Следният пример за код показва как да се изтегли и върне документ от посочената база данни, използвайки името на файла като ключ за извличане на този документ:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
public static Document ReadFromDatabase(string fileName, OleDbConnection mConnection)
{
    // Create the SQL command.
    string commandString = "SELECT * FROM Documents WHERE FileName='" + fileName + "'";
    OleDbCommand command = new OleDbCommand(commandString, mConnection);

    // Create the data adapter.
    OleDbDataAdapter adapter = new OleDbDataAdapter(command);

    // Fill the results from the database into a DataTable.
    DataTable dataTable = new DataTable();
    adapter.Fill(dataTable);

    // Check there was a matching record found from the database and throw an exception if no record was found.
    if (dataTable.Rows.Count == 0)
        throw new ArgumentException(string.Format("Could not find any record matching the document \"{0}\" in the database.", fileName));

    // The document is stored in byte form in the FileContent column.
    // Retrieve these bytes of the first matching record to a new buffer.
    byte[] buffer = (byte[])dataTable.Rows[0]["FileContent"];

    // Wrap the bytes from the buffer into a new MemoryStream object.
    MemoryStream newStream = new MemoryStream(buffer);

    // Read the document from the stream.
    Document doc = new Document(newStream);

    // Return the retrieved document.
    return doc;
}

Командата SQL по SSTLECT * се използва за извличане на съответния запис въз основа на името на файла.

Изтриване на документ от база данни

За да изтриете документ от базата данни, използвайте съответната команда SQL без никакви манипулации на Document Възразявам.

Следният пример за код показва как да изтриете документ от базата данни, като използвате името на файла, за да донесете записа:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
public static void DeleteFromDatabase(string fileName, OleDbConnection mConnection)
{
    // Create the SQL command.
    string commandString = "DELETE * FROM Documents WHERE FileName='" + fileName + "'";
    OleDbCommand command = new OleDbCommand(commandString, mConnection);

    // Delete the record.
    command.ExecuteNonQuery();

}