Saltar para o conteúdo principal
Versão: Próximo

BLOB TO DOCUMENT

BLOB TO DOCUMENT ( documento ; BLOB )

ParâmetroTipoDescrição
documentoString🡒Nome do documento gerado
BLOBBLOB🡒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