OPEN DATA FILE

4D v16.3

OPEN DATA FILE


OPEN DATA FILE ( endAcesso )

Parâmetro	Tipo	Descrição
endAcesso	String	Nome o endereço de acesso completo ao arquivo de dados a ser aberto

Descrição

O comando OPEN DATA FILE permite alterar os dados do arquivo aberto pela aplicação 4D on-the-fly.

Passe o nome ou o caminho de acesso completo do arquivo de dados a ser aberto (arquivo com extensão ".4DD") no parâmetro accessPath. Se você passar somente o nome do arquivo, ele deve ser colocado ao lado da estrutura de arquivo do banco de dados.

Se o caminho de acesso define um arquivo de dados válido, 4D fecha o banco de dados em andamento e re-abre-o com o arquivo de dados especificado. Os métodos de banco de dados Método banco de dados On Exit e Método banco de dados On Startup são sucessivamente chamados.

Atenção: Uma vez que este comando faz com que a aplicação seja fechada antes de abrir novamente com o arquivo de dados especificado, não é possível usá-lo no método Método banco de dados On Startup ou em um método chamado por este método de banco de dados.

O comando é executado de forma assíncrona: após a sua chamada, 4D continua a executar o restante do método. Então, a aplicação se comporta como se o comando Quit tivesse sido selecionado no menu Arquivo: abrir caixas de diálogo são cancelados, todos os processos abertos tem 10 segundos para terminar antes de ser encerrado, etc.

Antes de lançar a operação, o comando verifica a validade do arquivo de dados especificado. Além disso, se o arquivo já foi aberto, o comando verifica se ele corresponde à estrutura atual.

Se você passar uma string vazia em accessPath, o comando irá reabrir o banco de dados sem alterar o arquivo de dados.

4D Server: Começando com 4D v13, este comando pode ser executado com o 4D Server. Neste contexto, o comando faz uma chamada interna ao comando QUIT 4D no servidor (o qual faz que apareça uma caixa de diálogo em cada computador remoto indicando que o servidor está no processo de saída) antes de abrir o arquivo designado.

Exemplo

No contexto de implementação de uma aplicação fusionada, se quiser abrir ou criar o arquivo de dados de usuário no método de banco de dados On Startup. Este exemplo usa o arquivo de dados padrão (ver Gerenciamento de arquivo de dados em aplicativos finais):

 If(Data file="@default.4dd")

    If(Version type?? Merged application)

       If(Is data file locked)

          $dataPath:=Get 4D folder(Active 4D Folder)+"data.4dd"

  //se um arquivo local de dados já existir

          If(Test path name($dataPath)=Is a document)

             OPEN DATA FILE($dataPath) //abre o arquivo

          Else

             CREATE DATA FILE($dataPath) //cria o arquivo

          End if

       End if

    End if

 End if

Ver também

CREATE DATA FILE