Put

Carga los datos especificados en la URL indicada.

Nota: Acrobat y Adobe Reader no pueden comprobar si el formulario está certificado hasta el inicio del suceso initialize. Para utilizar la función Put en formularios certificados antes de la representación del formulario, utilice el suceso docReady.

Sintaxis

Put(s1, s2 [, s3 ])

Parámetros

Parámetro

Descripción

s1

La URL que se va a cargar.

s2

Los datos que se van a cargar.

Si la función no puede cargar los datos, devuelve un error.

s3 (opcional)

Cadena que contiene el nombre de la página de códigos empleada para codificar los datos. A continuación se detallan nombres de página de código válidos:

  • UTF-8 (valor predeterminado)

  • UTF-16

  • ISO8859-1

  • Cualquier codificación de caracteres admitida por la Autoridad de números asignados de Internet (IANA, del inglés Internet Assigned Numbers Authority)

Si no incluye un valor para s3, la función establece la página de código en el valor predeterminado. La aplicación garantiza que la codificación de los datos que se van a cargar coincida con la página de código especificada.

Ejemplos

La siguiente expresión es un ejemplo de uso de la función Put:

Expresión

Devuelve

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

Nada, si el servidor FTP ha permitido al usuario cargar algunos datos XML en el archivo pub/fubu.xml. En caso contrario, esta función devuelve un error.
Nota: este ejemplo solo se aplica en el entorno de servidor y no en Acrobat o Adobe Reader. Los formularios que se muestran en Acrobat y Adobe Reader utilizan los protocolos HTTP, HTTPS y FILE.