BLOB TO DOCUMENT

4D v20 R7

BLOB

BLOB TO DOCUMENT


BLOB TO DOCUMENT ( documento ; BLOB )

Parâmetro	Tipo	Descrição
documento	String	Nome do documento gerado
BLOB	BLOB	Novo conteúdo para o documento

Descrição

BLOB TO DOCUMENT reescreve todo o conteúdo do documento utilizando os dados armazenados no blob..
Você pode passar o nome de um documento existente no documento. Se o documento não existir, o comando o cria. Se você passar o nome de um documento existente, certifique-se que ele não está aberto, caso contrário, será gerado um erro. Se você quiser deixar o usuário escolher o documento, use os comandos Open document ou Create document e utilize a variável de processo documento (ver exemplo).

Nota de Compatibilidade: O * opcional (gestão de resource fork em versões antigas de Mac OS) não é mais compatível com 4D a partir de 4D v16. Para saber mais veja Propriedades obsoletas ou removidas.

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 salvar um documento que conterá os dados previamente carregados em um campo BLOB. O método para este botão pode ser:

 $vhDocRef:=Create document("") ` Salvar o documento a sua escolha

 If(OK=1) ` Se um documento já foi criado

    CLOSE DOCUMENT($vhDocRef) ` Não necessitamos mante-lo aberto

    BLOB TO DOCUMENT(Document;[SuaTabela]SeuCampoBLOB) ` Escrever o conteúdo do documento

    If(OK=0)

  ` Gerir erro

    End if

 End if

Variáveis e conjuntos do sistema

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

Tratamento de erros

Se você tentar reescrever um documento que não existe ou que já está aberto por outro processo ou aplicativo, o erro adequado do Gerenciador arquivo de é gerado.
O espaço em disco pode ser insuficiente para escrever o novo conteúdo do documento.
Erros de E / S pode ocorrer durante a redação do documento.

Em todos os casos, você pode interceptar o erro usando um método ON ERR CALL.

Ver também

Create document
DOCUMENT TO BLOB
Open document