Freigeben über


CObject::Dump

Speichert den Inhalt des Objekts in einen CDumpContext-Objekt.

virtual void Dump( 
   CDumpContext& dc  
) const;

Parameter

  • dc
    Der Dumpkontext Diagnose für das Sichern, normalerweise afxDump.

Hinweise

Wenn Sie eine eigene Klasse schreiben, sollten Sie die Dump-Funktion überschreiben, um Diagnosedienste für sich und andere Benutzer der Klasse bereitzustellen. Überschriebene Dump ruft normalerweise die Dump-Funktion ihrer Basisklasse auf, bevor Datenmember eindeutig der abgeleiteten Klasse ausgibt. CObject::Dump druckt den Klassennamen, wenn die Klasse das IMPLEMENT_DYNAMIC oder IMPLEMENT_SERIAL-Makro verwendet.

Hinweis

die Dump-Funktion sollte ein Zeilenumbruchzeichen nicht am Ende der Ausgabe drucken.

Dump Aufrufe sinnvoll sind nur in der Debugversion Microsoft Foundation Class-Bibliothek. Sie sollten Aufrufe, Funktionsdeklarationen und Implementierungen mit #ifdef _DEBUG/#endif-Anweisungen für die bedingte Kompilierung markieren.

Da Dump eine const-Funktion ist, werden Sie nicht zulässig, um den Objektzustand während des Dumps zu ändern.

Operator CDumpContext-Einfügung (<<) ruft Dump auf, wenn ein CObject Zeiger eingefügt wird.

Dump ermöglicht "azyklisches" von Objekten nur speichern. Sie können eine Liste von Objekten speichern, beispielsweise jedoch, wenn eines der Objekte die Liste selbst ist, durchlaufen Sie schließlich der Stapel über.

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen CObject Beispielen verwendet wird.

void CAge::Dump(CDumpContext &dc) const
{
   CObject::Dump(dc);
   dc << _T("Age = ") << m_years;
}

Anforderungen

Header: afx.h

Siehe auch

Referenz

CObject-Klasse

Hierarchiediagramm