Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.
Simplifica trabalhar com objetos de dados binários muito grandes (frequentemente chamados BLOBs, ou "objetos binários grandes") numa base de dados.
Sintaxe
class CLongBinary : public CObject
Membros
Construtores Públicos
| Nome | Description |
|---|---|
| CLongBinary::CLongBinary | Constrói um CLongBinary objeto. |
Membros de Dados Públicos
| Nome | Description |
|---|---|
| CLongBinary::m_dwDataLength | Contém o tamanho real em bytes do objeto de dados cujo handle está armazenado em m_hData. |
| CLongBinary::m_hData | Contém um handle HGLOBAL do Windows para o objeto imagem real. |
Observações
Por exemplo, um campo de registo numa tabela SQL pode conter um bitmap representando uma imagem. Um CLongBinary objeto armazena tal objeto e regista o seu tamanho.
Observação
Em geral, é melhor prática usar CByteArray em conjunto com a função DFX_Binary . Ainda pode usar CLongBinary, mas em geral CByteArray oferece mais funcionalidades no Win32, já que já não existe a limitação de tamanho encontrada nos 16 bits CByteArray. Este conselho aplica-se à programação com Objetos de Acesso a Dados (DAO), bem como à Conectividade de Bases de Dados Abertas (ODBC).
Para usar um CLongBinary objeto, declare um membro de dados de campo do tipo CLongBinary na sua classe de registos. Este membro será um membro embutido da classe do conjunto de registos e será construído quando o conjunto de registos for construído. Após a construção do CLongBinary objeto, o mecanismo de troca de campos de registo (RFX) carrega o objeto de dados a partir de um campo no registo atual na fonte de dados e armazena-o de volta no registo quando o registo é atualizado. O RFX consulta a fonte de dados para o tamanho do objeto binário grande, aloca armazenamento para ele (através do CLongBinary elemento de dados do m_hData objeto) e armazena um HGLOBAL handle para os dados em m_hData. O RFX também armazena o tamanho real do objeto de dados no m_dwDataLength membro de dados. Trabalhe com os dados no objeto através m_hDatade , usando as mesmas técnicas que normalmente usaria para manipular os dados armazenados num handle do Windows HGLOBAL .
Quando destrói o seu conjunto de registos, o objeto embutido CLongBinary também é destruído, e o seu destruidor desaloca o HGLOBAL handler de dados.
Para mais informações sobre objetos grandes e a utilização de CLongBinary, consulte os artigos Recordet (ODBC) e Recordet: Working with Large Data Items (ODBC).
Hierarquia de herança
CLongBinary
Requerimentos
Cabeçalho: afxdb_.h
CLongBinary::CLongBinary
Constrói um CLongBinary objeto.
CLongBinary();
CLongBinary::m_dwDataLength
Armazena o tamanho real em bytes dos dados armazenados no handle HGLOBAL em m_hData.
SQLULEN m_dwDataLength;
Observações
Este tamanho pode ser menor do que o tamanho do bloco de memória alocado para os dados. Chama a função Win32 GLobalSize para obter o tamanho alocado.
CLongBinary::m_hData
Armazena um handle HGLOBAL do Windows nos dados binários de objetos grandes reais.
HGLOBAL m_hData;