CArchive-Klasse

Artikel
02/26/2013

Ermöglicht es Ihnen, ein komplexes Netzwerk von Objekten in einer permanenten binären Form (normalerweise Festplattenspeicher) sichern die weiter besteht, nachdem diese Objekte gelöscht wurden.

class CArchive

Mitglieder

Öffentliche Konstruktoren

Name	Description
CArchive::CArchive	Erstellt ein CArchive-Objekt.

Öffentliche Methoden

Name	Description
CArchive::Abort	Schließt ein Archiv, ohne eine Ausnahme auszulösen.
CArchive::Close	Leert ungeschriebene Daten und Trennungen von CFile.
CArchive::Flush	Ungeschriebene Daten des Leerens vom Archivpuffer.
CArchive::GetFile	Ruft den CFile-Objektzeiger für dieses Archiv ab.
CArchive::GetObjectSchema	Aufgerufen aus der Serialize-Funktion, um die Version des Objekts zu bestimmen, das deserialisiert wird.
CArchive::IsBufferEmpty	Bestimmt, ob der Puffer während Windows Sockets empfangen Prozess geleert wurde.
CArchive::IsLoading	Bestimmt, ob das Archiv lädt.
CArchive::IsStoring	Bestimmt, ob das Archiv speichert.
CArchive::MapObject	Setzt Objekte in der Zuordnung, die nicht zur Datei serialisiert werden, aber die verfügbar sind, damit Unterobjekte verweisen.
CArchive::Read	Liest unformatierte Bytes.
CArchive::ReadClass	Liest einen Klassenverweis, der zuvor mit WriteClass gespeichert wird.
CArchive::ReadObject	Ruft Serialize-Funktion eines Objekts zum Laden auf.
CArchive::ReadString	Liest eine einzelne Textzeile.
CArchive::SerializeClass	Liest oder schreibt den Klassenverweis zum CArchive-Objekt abhängig von der Richtung CArchive.
CArchive::SetLoadParams	Legt die Größe fest, auf die das Lastarray vergrößert.Muss aufgerufen werden, bevor ein Objekt geladen wird, oder bevor MapObject oder ReadObject aufgerufen wird.
CArchive::SetObjectSchema	Legt das Objektschema fest, das im Archivobjekt gespeichert wird.
CArchive::SetStoreParams	Legt die Hashtabellengröße und die Blockgröße der Zuordnung fest, die verwendet wird, um eindeutige Objekte während des Serialisierungsprozesses zu identifizieren.
CArchive::Write	Schreibt unformatierte Bytes.
CArchive::WriteClass	Schreibt CArchive einen Verweis auf CRuntimeClass.
CArchive::WriteObject	Ruft Serialize-Funktion eines Objekts zum Speichern auf.
CArchive::WriteString	Schreibt eine einzelne Textzeile.

Öffentliche Operatoren

Name	Description
CArchive::operator <<	Speicherobjekte und -primitive Typen zum Archiv.
CArchive::operator >>	Lastobjekte und -primitive Typen vom Archiv.

Öffentliche Datenmember

Name	Description
CArchive::m_pDocument

Hinweise

CArchive hat keine Basisklasse.

Später können Sie die Objekte im permanenten Speicher laden und diese im Arbeitsspeicher erneut erstellen.Dieser Prozess gehindert Daten erhalten wird aufgerufen "Serialisierung".

Sie können sich ein Archivobjekt als Art Binärstream vorstellen.Wie ein Eingabe/Ausgabe-Stream wird ein Archiv mit einer Datei zugeordnet und die gepufferte das Schreiben und Lesen von Daten nach und von Speicher zulässt.Prozessfolgen eines Eingabe/Ausgabe-Streams von ASCII-Zeichen, aber ein Archiv verarbeitet binäre Objektdaten in einem effizienten, nonredundant Format.

Sie müssen ein Die C-Datei-Objekt erstellen, bevor Sie ein CArchive-Objekt erstellen können.Außerdem müssen Sie sicherstellen, dass der Methoden/Speicherstatus des Archivs mit dem geöffneten Modus der Datei kompatibel ist.Sie werden auf einen aktiven Archiv pro Datei beschränkt.

Wenn Sie ein CArchive-Objekt erstellen, es zu einem Objekt der Klasse CFile an (oder der abgeleiteten Klasse) die eine geöffnete Datei darstellt.Sie geben auch an, ob das Archiv zum Laden oder Speichern verwendet wird.Ein Objekt, CArchive kann nicht nur primitive Typen verarbeiten jedoch gilt auch von den von CObject abgeleiteten Klassen, für die Serialisierung entworfen wurden.Eine serialisierbare Klasse ist normalerweise eine Serialize-Memberfunktion, und verwendet normalerweise die DECLARE_SERIAL und IMPLEMENT_SERIAL-Makros, wie unter Klasse CObject beschrieben.

Die überladenen Operatoren der Extraktion (>>) und Einfügen (<<) sind Programmierung Schnittstellen des einfachen Archivs, die primitive Typen und CObject von abgeleitete Klassen unterstützen.

CArchive unterstützt auch Programmieren mit den MFC-WindowsSocket-Klassen CSocket und CSocketFile.Die IsBufferEmpty-Memberfunktionsunterstützung die Verwendung.

Weitere Informationen zu CArchive, finden Sie in Artikel Serialisierung und Windows Sockets: Verwenden von Sockets mit Archiven.