4D Doc Center : DOCUMENT TO BLOB

4D v14.3

BLOB

DOCUMENT TO BLOB


DOCUMENT TO BLOB ( documento ; BLOB {; *} )

Parâmetro	Tipo	Descrição
documento	cadeia	Nome do documento gerado
BLOB	BLOB	Campo ou variável de tipo BLOB a receber o documento
		Conteúdo do documento
*	Operador	Somente em Macintosh: Resource fork é carregado se o parâmetro * for passado, caso contrário é carregado Data fork

Descrição

DOCUMENT TO BLOB carrega todo o conteúdo do documento em blob. Você deve passar o nome de um documento existente que não esteja aberto, caso contrário um erro será gerado. Para deixar o usuário escolher o documento a ser carregado para o BLOB, use o comando Open document e variável de processo do documento (ver exemplo).

Nota para os usuários Macintosh: Nota sobre Macintosh: documentos Macintosh pode ser compostos de dois forks: o fork de dados e o fork de recurso. Por padrão, o comando DOCUMENT TO BLOB carrega o fork de dados do documento. Para carregar o fork de recursos do documento, passe o parâmetro opcional *.

No Windows, o parâmetro opcional * é ignorado. Observe que o ambiente 4D oferece o equivalente de fork de recursos Mac OS no Windows. Por exemplo, o fork de dados de um banco de dados 4D é armazenado em um arquivo com a extensão .4DB; O fork de recurso é armazenado em um arquivo com o mesmo nome e extensão do arquivo .RSR. No Windows, se você escrever uma aplicação 4D com fork de dados e fork de recursos armazenados em BLOBs, você só precisa acessar o arquivo correspondente ao fork com o qual deseja trabalhar.

Exemplo

Você escreve um Sistema de Informação que permite rapidamente armazenar e recuperar documentos. Em um formulário de entrada de dados, você cria um botão que permite carregar um documento em um campo BLOB. O método para este botão pode ser:

 $vhDocRef:=Open document("") ` Selecionar um documento

 If(OK=1) ` Se um documento foi selecionado

    CLOSE DOCUMENT($vhDocRef) ` Não necessitamos manter aberto

    DOCUMENT TO BLOB(Document;[SuTabla]SuCampoBLOB) ` Carregar o documento

    If(OK=0)

  ` Controlar erro

    End if

 End if

Variáveis e conjuntos do sistema

OK é definido como 1 se o documento foi carregado corretamente, caso contrário, OK é definido como 0 e um erro é gerado.

Tratamento de erros

Se você tentar carregar (em um BLOB), um documento que não existe ou que já está aberto por outro processo ou aplicativo, o erro adequado do Gerenciador de Arquivos é gerado.
Um erro de E / S pode ocorrer se o documento está bloqueado, localizado em um volume fechado, ou se houver problema na leitura do documento.
Se não houver memória suficiente para carregar o documento, um erro -108 é gerado.

Em cada caso, você pode interceptar o erro usando um método de interrupção ON ERR CALL.