Cria um arquivo em um diretório no dispositivo móvel.

Open

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.file.createFile()

Retorno

Se o arquivo for criado com sucesso, o bloco retorna nulo.

Parâmetros

Diretório

Neste parâmetro deve ser inserido o bloco Obter Diretório, que especifica o diretório que deverá ser criado o arquivo.

• Posição: 1

• Inglês: Directory

• Tipo: Texto / String

• Exemplo: uso do bloco Obter Diretório

Nome do Arquivo

Nome do arquivo a ser criado.

• Posição: 2

• Inglês: File Name

• Tipo: Texto / String

• Exemplo: "meuArquivo.txt"

Conteúdo

Conteúdo a ser adicionado ao arquivo.

• Posição: 3

• Inglês: Content

• Tipo: Texto / String

• Exemplo: "Este conteúdo será adicionado ao arquivo criado"

Sucesso

Executa uma ação caso o arquivo seja criado com sucesso.

• Posição: 4

• Inglês: Success

• Tipo: Comando com retorno ("item") / Command with return ("item")

• Exemplo: uso do bloco Exibir Notificação

Erro

Executa uma ação caso ocorra um erro durante a criação do arquivo.

• Posição: 5

• Inglês: Error

• Tipo: Comando com retorno ("item") / Command with return ("item")

• Exemplo: uso do bloco Exibir Notificação

Exemplo

A função abaixo mostra um exemplo de uso do bloco Criar Arquivo. No parâmetro Diretório, inserimos o bloco Obter Diretório, indicando que o arquivo deverá ser criado no diretório interno do dispositivo móvel. Também inserimos o nome e o conteúdo do arquivo criado.

O bloco Exibir Notificação retornará uma mensagem a depender do resultado da criação do arquivo. Caso ocorra com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, caso contrário, os comandos em Erro são executados. Para obter o conteúdo do arquivo criado, pode-se utilizar o bloco Ler Arquivo.

Open

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Criar Arquivo", a função será executada e o arquivo será criado. Na imagem, vemos a notificação exibida após esta ação.

Open

Nesta página