Partilhar via


Classe CLongBinary

Simplifica o trabalho com objetos de dados binários muito grandes (geralmente chamados de BLOBs ou "objetos binários grandes") em um banco de dados.

Sintaxe

class CLongBinary : public CObject

Membros

Construtores públicos

Nome Descrição
CLongBinary::CLongBinary Constrói um objeto CLongBinary.

Membros de Dados Públicos

Nome Descrição
CLongBinary::m_dwDataLength Contém o tamanho real em bytes do objeto de dados cujo identificador está armazenado em m_hData.
CLongBinary::m_hData Contém um identificador HGLOBAL do Windows para o objeto de imagem real.

Comentários

Por exemplo, um campo de registro em uma tabela SQL pode conter um bitmap representando uma imagem. Um objeto CLongBinary armazena esse objeto e controla seu tamanho.

Observação

Em geral, agora é melhor usar CByteArray em conjunto com a função DFX_Binary. Você ainda pode usar CLongBinary, mas em geral CByteArray fornece mais funcionalidade no Win32, já que não há mais a limitação de tamanho encontrada em 16 bits CByteArray. Esse conselho se aplica à programação com DAO (Objetos de Acesso a Dados), bem como ODBC (Open Database Connectivity).

Para usar um objeto CLongBinary, declare um membro de dados de campo do tipo CLongBinary em sua classe de conjunto de registros. Esse membro será um membro inserido da classe de conjunto de registros, e será construído quando o conjunto de registros for construído. Depois que o objeto CLongBinary é construído, o mecanismo rfx (troca de campo de registro) carrega o objeto de dados de um campo no registro atual na fonte de dados e o armazena de volta para o registro quando o registro é atualizado. A RFX consulta a fonte de dados pelo tamanho do objeto binário grande, aloca o armazenamento para ele (por meio do membro de dados m_hData do objeto CLongBinary) e armazena um identificador HGLOBAL para os dados em m_hData. A RFX também armazena o tamanho real do objeto de dados no membro de dados m_dwDataLength. Trabalhe com os dados no objeto por meio de m_hData, usando as mesmas técnicas que normalmente você usaria para manipular os dados armazenados em um identificador do Windows HGLOBAL.

Quando você destrói o conjunto de registros, o objeto inserido CLongBinary também é destruído, e seu destruidor desaloca o identificador de dados HGLOBAL.

Para obter mais informações sobre objetos grandes e o uso de CLongBinary, consulte os artigos Conjunto de registros (ODBC) e Conjunto de registros: trabalhar com itens de dados grandes (ODBC).

Hierarquia de herança

CObject

CLongBinary

Requisitos

Cabeçalho afxdb.h

CLongBinary::CLongBinary

Constrói um objeto CLongBinary.

CLongBinary();

CLongBinary::m_dwDataLength

Armazena o tamanho real em bytes dos dados armazenados no identificador HGLOBAL em m_hData.

SQLULEN m_dwDataLength;

Comentários

Esse tamanho pode ser menor do que o tamanho do bloco de memória alocado para os dados. Chame a função Win32 GLobalSize para obter o tamanho alocado.

CLongBinary::m_hData

Armazena um identificador HGLOBAL do Windows para os dados de objetos grandes binários reais.

HGLOBAL m_hData;

Confira também

Classe CObject
Gráfico da hierarquia
Classe CRecordset