Partilhar via


DFX_Binary

Transfere matrizes de bytes entre os membros de dados do campo de um objeto de CDaoRecordset e as colunas de um registro na fonte de dados.

void AFXAPI DFX_Binary( 
   CDaoFieldExchange* pFX, 
   LPCTSTR szName, 
   CByteArray& value, 
   int nPreAllocSize = AFX_DAO_BINARY_DEFAULT_SIZE, 
   DWORD dwBindOptions = 0  
);

Parâmetros

  • pFX
    Um ponteiro para um objeto da classe CDaoFieldExchange. Esse objeto contém informações para definir o contexto para cada chamada da função.

  • szName
    O nome de uma coluna de dados.

  • valor
    O valor armazenado no membro de dados indicado — o valor a ser transferido. Para uma transferência do conjunto de registros com a fonte de dados, o valor, do tipo CByteArray, é obtido do membro de dados especificado. Para uma transferência da fonte de dados ao conjunto de registros, o valor é armazenado no membro de dados especificado.

  • nPreAllocSize
    A estrutura preallocates essa quantidade de memória. Se os dados forem maiores, a estrutura mais espaço alocado quando necessário. Para melhor desempenho, defina esse tamanho em um valor grande o bastante para evitar redistribuições. O tamanho padrão é definido no arquivo de AFXDAO.H como AFX_DAO_BINARY_DEFAULT_SIZE.

  • dwBindOptions
    Uma opção que permite usufruir o mecanismo de proteção duplo MFC para detectar os campos do conjunto de registros que foram alterados. A opção, AFX_DAO_DISABLE_FIELD_CACHE, não usar a proteção duplas, e você deve chamar SetFieldDirty e SetFieldNull você mesmo. Outro valor possível, AFX_DAO_ENABLE_FIELD_CACHE, proteção duplo do, e você não tem que fazer o trabalho adicional para marcar os campos incorretos ou nulos. Por razões de desempenho e de memória, evite esse valor como menos que os dados binários são relativamente pequenos.

    Dica

    Você pode controlar se os dados são duplicadas em buffer para todos os campos por padrão definindo CDaoRecordset::m_bCheckCacheForDirtyFields.

Comentários

Os dados são mapeados entre o tipo DAO_BYTES em DAO e o tipo CByteArray no conjunto de registros.

Exemplo

Consulte DFX_Text.

Requisitos

Header: afxdao.h

Consulte também

Referência

DFX_Text

DFX_Bool

DFX_Currency

DFX_Long

DFX_Short

DFX_Single

DFX_Double

DFX_DateTime

DFX_Byte

DFX_LongBinary

CDaoFieldExchange::SetFieldType

Conceitos

Macros e globais MFC