URLSaveAsynchronous

URLSaveAsynchronousは，バージョン11.2で実験的に導入されたURLDownloadSubmitに置き換えられた．

URLSaveAsynchronous["url","file",func]

イベントが起ると func を呼び，バックグラウンドで"file"にダウンロードする．

詳細とオプション

  • 起り得るイベントタイプ
  • "data"接続が完了したことを示すために使える空リストを返す
    "progress"現行接続に関する情報を{dlnow,dltotal,ulnow,ultotal}の形で返す
    "error"URLに接続を試みた際にエラーが起ったことを示す
    "headers"Webサーバから受け取ったヘッダ
    "cookies"既知のクッキーすべてのリスト
    "statuscode"サーバから返されたステータスコード
  • 使用可能なオプション
  • Method"GET"リクエストに使用するメソッド
    "Parameters" {}リクエストに送られるパラメータ
    "Body"""送信するメッセージ本体のコンテンツ
    "MultipartElements"{}送信する複数部分からなるデータのリスト
    "Username" ""リクエストに使用するユーザ名
    "Password" ""リクエストに使用するパスワード
    "Headers" {}HTTPサーバにマニュアルで送るヘッダ
    "Cookies" Automaticサーバに渡すクッキー
    "StoreCookies" True受信したクッキーを保存するかどうか
    "VerifyPeer" TrueSSL認証を使って信頼性を証明
    "UserAgent" Automatic送信するユーザエージェント文字列
    "ReadTimeout" 0データのアップロード／ダウンロードに許容する時間
    "ConnectTimeout" 0サーバへの接続に許容する時間
    "Progress" False"progress"イベントを引き起すかどうか
    "Transfer"AutomaticAutomaticのときは，"data"イベントが1回返され，ダウンロードされたすべてのデータを返す．"Chunks"であれば，最後のイベントが引き起こされた後でダウンロードされたデータを使って"data"イベントが何回も引き起される
    "UserData" Noneこのオプションに渡された式はいかなるものも，イベント関数の中のAsynchronousTaskObjectで使うために保存される．データは，イベント関数に渡されたAsynchronousTaskObjectのオプションを調べることで見付けることができる
    BinaryFormatTrue新規行あるいは他のデータのテキスト解釈を避けるかどうか
    "FollowRedirects"Trueリダイレクトに従うかどうか
  • イベントが起ると，URLSaveAsynchronousに渡されたイベント関数が実行される．イベント関数には，AsynchronousTaskObject，イベント名，イベントから受け取ったデータの3つの引数が渡される．イベント関数はURLSaveAsynchronousから受け取ったデータを処理する唯一のメソッドである．

例題

すべて開くすべて閉じる

例  (1)

URLからファイルにコンテンツをダウンロードしている間，進行状態をモニターする：

オプション  (15)

"Method"  (1)

"Method"を使って接続で使うHTTPメソッドを指定することができる：

"Parameters"  (1)

サーバに送られるパラメータを指定する：

"VerifyPeer"  (1)

サーバが使うSSL認証が有効であることを確認する：

"Username"  (1)

サーバに送られるユーザ名を指定する：

"Password"  (1)

サーバに送られるパスワードを指定する：

"UserAgent"  (1)

サーバに送られるユーザエージェントを指定する：

"Cookies"  (1)

URLSaveAsynchronousが使うクッキーを手動で制御する：

"StoreCookies"  (1)

Falseの場合，"StoreCookies"はサイトに接続中に見付かった任意の新たなクッキーを大域的クッキー共有には置かない：

"Headers"  (1)

サーバに送るヘッダを指定する：

"BodyData"  (1)

サーバに接続する際に送られるメッセージ本体を指定する：

"MultipartData"  (1)

複数部分からなるメッセージ本体のコンテンツを指定する：

"ReadTimeout"  (1)

サーバからのダウンロードを終了するまでの最大割当て時間を秒で指定する：

"ConnectTimeout"  (1)

サーバへの接続を確立するまでの最大割当て時間を秒で指定する：

"Progress"  (1)

Trueの場合，"progress"イベントが引き起こされ，実行中のダウンロードについてダウンロードおよびアップロードされた情報が返される：

"UserData"  (1)

"UserData"はイベントが呼ばれた場合に入手可能になる情報を含む任意の式である：

特性と関係  (1)

URLFetchAsynchronousを使って直接Wolfram言語にコンテンツをロードする：

Wolfram Research (2012), URLSaveAsynchronous, Wolfram言語関数， https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html.

テキスト

Wolfram Research (2012), URLSaveAsynchronous, Wolfram言語関数， https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html.

CMS

Wolfram Language. 2012. "URLSaveAsynchronous." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html.

APA

Wolfram Language. (2012). URLSaveAsynchronous. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html

BibTeX

@misc{reference.wolfram_2024_urlsaveasynchronous, author="Wolfram Research", title="{URLSaveAsynchronous}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html}", note=[Accessed: 21-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_urlsaveasynchronous, organization={Wolfram Research}, title={URLSaveAsynchronous}, year={2012}, url={https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html}, note=[Accessed: 21-November-2024 ]}