4D Doc Center : BLOB TO DOCUMENT

4D v14.3

BLOB

BLOB TO DOCUMENT


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

Parâmetro	Tipo	Descrição
documento	cadeia	Nome do documento gerado
BLOB	BLOB	Novo conteúdo para o documento
*	Operador	Somente Macintosh: Resource fork é escrito se for passado *; caso contrário, Data fork é escrito

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 no documento. Se o documento não existir, o comando 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 para usuários Macintosh:

Documentos Macintosh podem ser compostos de dois forks: o fork de dados e fork de recurso. Por padrão, o comando BLOB TO DOCUMENT reescreve a os fork de dados do documento. Para reescrever o fork de recurso do documento, passe o parâmetro opcional *. No Windows, o parâmetro opcional * é ignorado.
Os documentos gerados por este comando não tem um "tipo". Se você deseja criar um documento com um tipo, você deve usar o comando SET DOCUMENT TYPE.

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.