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
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;