Put

渡されたデータを指定した URL にアップロードします。

注意： Acrobat と Adobe Reader では、initialize イベントが開始されるまでは、フォームが認証済みかどうかを確認できません。フォームをレンダリングする前に、認証済みのフォームで Put 関数を使用する場合は、docReady イベントを使用します。

構文

Put(s1, s2 [, s3 ])

パラメーター

パラメーター

説明

s1

アップロードする URL です。

s2

アップロードするデータです。

データをアップロードできない場合は、エラーを返します。

s3（オプション）

データをエンコードするために使用するコードページの名前を含む文字列です。有効なコードページ名は、以下のとおりです。

  • UTF-8（デフォルト値）

  • UTF-16

  • ISO8859-1

  • Internet Assigned Numbers Authority（IANA）によって登録されている任意の文字エンコーディング

s3 に値を指定しないと、コードページはデフォルト値に設定されます。アプリケーションでは、指定したコードページに一致するエンコーディングのデータがアップロードされます。

例

次に示す式は Put 関数の使用例です。

式

戻り値

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

XML データを pub/fubu.xml ファイルにアップロードすることを FTP サーバーがユーザーに許可している場合は、何も返しません。それ以外の場合は、エラーを返します。
注意： この例はサーバー環境でのみ使用でき、Acrobat または Adobe Reader では使用できません。Acrobat および Adobe Reader で表示されるフォームでは、HTTP、HTTPS および FILE プロトコルを使用します。