Post

渡されたデータを指定した URL にポストします。

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

構文

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

パラメーター

パラメーター

説明

s1

ポストする URL です。

s2

ポストするデータです。

データをポストできない場合は、エラーを返します。

s3（オプション）

ポストするデータのコンテンツタイプを含む文字列です。有効なコンテンツタイプは、以下のとおりです。

  • application/octet-stream（デフォルト値）

  • text/html

  • text/xml

  • text/plain

  • multipart/form-data

  • application/x-www-form-urlencoded

  • その他の有効な MIME タイプ

s3 に値を指定しないと、コンテンツタイプはデフォルト値に設定されます。アプリケーションでは、指定したコンテンツタイプに沿った正しい形式のデータがポストされます。

s4（オプション）

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

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

  • UTF-16

  • ISO-8859-1

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

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

s5（オプション）

データのポストに付属する HTTP ヘッダーを含む文字列です。

s5 に値を指定しないと、ポスト時に HTTP ヘッダーが含まれません。

SOAP サーバーの場合は通常、ポスト時に SOAPAction ヘッダーが必要です。

例

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

式

戻り値

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

URL エンコードされたいくつかのログインデータをサーバーにポストし、サーバーが認識したページを返します。

 
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")

ローカル時間の SOAP 要求をいくつかのサーバーにポストし、XML 応答が戻ってくることを期待します。