Compartilhar via


CObject::Dump

Despeja o conteúdo do objeto a um objeto de CDumpContext .

virtual void Dump(
   CDumpContext& dc 
) const;

Parâmetros

  • dc
    O contexto de diagnóstico despejo para despejar, geralmente afxDump.

Comentários

Quando você escrever sua própria classe, você deve substituir a função de Dump para fornecer serviços diagnóstico para você mesmo e outros usuários de sua classe.Dump substituído normalmente chama a função de Dump de sua classe base antes de impressão membros de dados exclusivo a classe derivada.CObject::Dump imprime o nome da classe se a classe usa a macro de IMPLEMENT_DYNAMIC ou de IMPLEMENT_SERIAL .

ObservaçãoObservação

A função de Dump não deve imprimir um caractere de nova linha no final de sua saída.

Chamadas deDump fazem sentido somente na versão de depuração de biblioteca de classes da Microsoft foundation.Você deve suportar chamadas, declarações de função, e implementações de função com #ifdef _DEBUG/instruções de#endif para compilação condicional.

Desde que Dump é uma função de const , você não é permitido para alterar o estado do objeto durante despejo.

Operador de inserção CDumpContext (<<) chama Dump quando um ponteiro de CObject é inserido.

Dump permite apenas o despejo “acíclico” de objetos.Você pode despejar uma lista de objetos, por exemplo, mas se um dos objetos é a lista em si, você transbordará na pilha.

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge usada em todos os exemplos de CObject .

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

Requisitos

Cabeçalho: afx.h

Consulte também

Referência

Classe de CObject

Gráfico de hierarquia