Post

Envia 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 Post em formulários certificados antes da renderização desses formulários, use o evento docReady.

Sintaxe

Post(s1, s2 [, s3 [, s4 [, s5 ]]])

Parâmetros

Parâmetro

Descrição

s1

O URL para o qual enviar.

s2

Os dados a serem enviados.

Se a função não conseguir enviar os dados, um erro será retornado.

s3 (opcional)

Uma string contendo o tipo de conteúdo dos dados a serem enviados. Os tipos de conteúdo válidos são:

  • application/octet-stream (valor padrão)

  • text/html

  • text/xml

  • text/plain

  • multipart/form-data

  • application/x-www-form-urlencoded

  • Qualquer outro tipo MIME válido

Se um valor para s3 não for incluído, a função definirá o tipo de conteúdo como o valor padrão. O aplicativo garante que os dados a serem enviados usam o formato correto de acordo com o tipo de conteúdo especificado.

s4 (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

  • ISO-8859-1

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

Se um valor para s4 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 enviados corresponde à página de códigos especificada.

s5 (opcional)

Uma string contendo cabeçalhos HTTP adicionais a serem incluídos com o envio dos dados.

Se um valor para s5 não for incluído, a função não incluirá um cabeçalho HTTP adicional no envio.

Em geral, servidores SOAP requerem um cabeçalho SOAPAction para esse envio.

Exemplos

As expressões a seguir são exemplos de uso da função Post:

Expressão

Retorna

 
Post("http://tools_build/scripts/jfecho.cgi", 
"user=joe&passwd=xxxxx&date=27/08/2002", 
"application/x-www-form-urlencoded")

Envia alguns dados de login codificados em URL para um servidor e retorna a página de reconhecimento do servidor.

 
Post("http://www.nanonull.com/TimeService/ 
TimeService.asmx/getLocalTime", "<?xml version='1.0' 
encoding='UTF-8'?><soap:Envelope><soap:Body> 
<getLocalTime/></soap:Body> 
</soap:Envelope>", "text/xml", "utf-8", 
"http://www.Nanonull.com/TimeService/getLocalTime")

Envia uma solicitação SOAP para o horário local a algum servidor, aguardando o retorno de uma resposta XML.