Put

Carrega os dados especificados para o URL especificado.

Nota: O Acrobat e o Adobe Reader não poderão verificar se o formulário está certificado até que o evento initialize tenha sido iniciado. Para usar a função Put em formulários certificados antes da renderização desses formulários, use o evento docReady.

Sintaxe

Put(s1, s2 [, s3 ])

Parâmetros

Parâmetro

Descrição

s1

O URL para o qual carregar.

s2

Os dados a serem carregados.

Se a função não conseguir carregar os dados, ela retornará um erro.

s3 (opcional)

Uma string contendo o nome da página de códigos para codificar os dados. Os nomes válidos de página de códigos são:

  • UTF-8 (valor padrão)

  • UTF-16

  • ISO8859-1

  • Qualquer codificação de caractere listada pela IANA (Internet Assigned Numbers Authority)

Se um valor para s3 não for incluído, a função definirá a página de códigos como o valor padrão. O aplicativo garante que a codificação dos dados a serem carregados corresponde à página de códigos especificada.

Exemplos

A seguinte expressão exemplifica o uso da função Put:

Expressão

Retorna

 
Put("ftp://www.example.com/pub/fubu.xml", 
"<?xml version='1.0' 
encoding='UTF-8'?><msg>hello world!</msg>")

Nada se o servidor FTP permitiu que o usuário carregasse alguns dados XML para o arquivo pub/fubu.xml. Caso contrário, essa função retornará um erro.
Nota: Este exemplo só funciona no ambiente do servidor e não no Acrobat ou Adobe Reader. Os formulários exibidos no Acrobat e no Adobe Reader usam os protocolos HTTP, HTTPS e FILE.