Put

Lädt die angegebenen Daten zu der genannten URL hoch.

Hinweis: Acrobat und Adobe Reader können erst nach dem Initiieren des Ereignisses initialize prüfen, ob das Formular zertifiziert ist. Soll die Funktion Put vor der Formularwiedergabe bei zertifizierten Formularen eingesetzt werden, verwenden Sie das Ereignis docReady .

Syntax

Put( s1 , s2 [, s3 ])

Parameter

Parameter

Beschreibung

s1

Die URL, zu der Daten hochgeladen werden sollen.

s2

Die hochzuladenden Daten.

Wenn die Funktion die Daten nicht hochladen kann, gibt sie einen Fehler zurück.

s3 (optional)

Eine Zeichenfolge mit dem Namen der für die Kodierung der Daten verwendeten Codepage. Folgende Codepage-Namen sind gültig:

  • UTF-8 (Standardwert)

  • UTF-16

  • ISO8859-1

  • Jede von der Internet Assigned Numbers Authority (IANA) aufgeführte Zeichenkodierung

Wenn Sie für s3 keinen Wert angeben, setzt die Funktion die Codepage auf den Standardwert. Die Anwendung gewährleistet, dass die Kodierung der hochzuladenden Daten der angegebenen Codepage entspricht.

Beispiele

Die folgende Tabelle zeigt ein Beispiel für die Verwendung der Funktion Put :

Ausdruck

Rückgabe 

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

Nichts, wenn der FTP-Server dem Benutzer die Genehmigung erteilt hat, XML-Daten in die Datei pub/fubu.xml hochzuladen. Andernfalls gibt diese Funktion einen Fehler zurück.

Hinweis: Dieses Beispiel kann nur in der Serverumgebung und nicht in Acrobat oder Adobe Reader verwendet werden. Nutzen Sie die Protokolle HTTP, HTTPS und FILE für Formulare, die in Acrobat und Adobe Reader angezeigt werden.