WOLFRAM

Wolfram言語 ＆ システムドキュメントセンター

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

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

詳細とオプション
Details and Options Details and Options
例題  
例  
オプション  
"Method"  
"Parameters"  
"VerifyPeer"  
Show More Show More
"Username"  
"Password"  
"UserAgent"  
"Cookies"  
"StoreCookies"  
"Headers"  
"BodyData"  
"MultipartData"  
"ReadTimeout"  
"ConnectTimeout"  
"Progress"  
"UserData"  
特性と関係  
関連項目
履歴
引用書式

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からファイルにコンテンツをダウンロードしている間，進行状態をモニターする：

Wolfram Language code: url = "http://exampledata.wolfram.com/10mb.dat"; progress = 0.; progFunction[_, "progress", {dlnow_, dltotal_, _, _}] := Quiet[progress = dlnow / dltotal]
Wolfram Language code: Dynamic[ProgressIndicator[progress]]
Wolfram Language code: URLSaveAsynchronous[url, FileNameJoin[{$TemporaryDirectory, "10mb.dat"}], progFunction, "Progress" -> True]

オプション  (15)

"Method"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://wolfram.com", tmpFile, Null, "Method" -> "HEAD"]
Wolfram Language code: FilePrint[tmpFile]

"Parameters"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/httpget.php", tmpFile, Null, "Parameters" -> {"name" -> "Joe", "age" -> "30"}]
Wolfram Language code: FilePrint[tmpFile]

"VerifyPeer"  (1)

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

Wolfram Language code: statusData; tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; eventFunction[_, "statuscode", status_] := statusData = status; URLSaveAsynchronous["https://wolfram.com", tmpFile, eventFunction, "VerifyPeer" -> True]
Wolfram Language code: statusData

"Username"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/authentication.php", tmpFile, Null, "Username" -> "Joe", "Password" -> ""]
Wolfram Language code: FilePrint[tmpFile]

"Password"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/authentication.php", tmpFile, Null, "Username" -> "Joe", "Password" -> "topsecret"]
Wolfram Language code: FilePrint[tmpFile]

"UserAgent"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/useragent.php", tmpFile, Null, "UserAgent" -> "Web Browser"]
Wolfram Language code: FilePrint[tmpFile]

"Cookies"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/cookies.php", tmpFile, Null, "Cookies" -> {{"Domain" -> ".exampledata.wolfram.com", "Path" -> "/", "Secure" -> "FALSE", "Expires" -> DateString[{2020, 1, 1, 0, 0, 0}], "Name" -> "MyCookie", "Value" -> "CookieData"}}]
Wolfram Language code: FilePrint[tmpFile]

"StoreCookies"  (1)

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

Wolfram Language code: cookiesData; tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; eventFunction[_, "cookies", cookies_] := cookiesData = cookies URLSaveAsynchronous["http://wolfram.com/", tmpFile, eventFunction, "StoreCookies" -> False]
Wolfram Language code: cookiesData
Wolfram Language code: $HTTPCookies

"Headers"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/headers.php", tmpFile, Null, "Headers" -> {"MyHeader" -> "42"}]
Wolfram Language code: FilePrint[tmpFile]

"BodyData"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/bodydata.php", tmpFile, Null, "BodyData" -> "Message body data sent to server."]
Wolfram Language code: FilePrint[tmpFile]

"MultipartData"  (1)

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

Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/multipartdata.php", tmpFile, Null, "MultipartData" -> {{"partName", "mime/type", {1, 2, 3, 4, 5}}}];
Wolfram Language code: FilePrint[tmpFile]

"ReadTimeout"  (1)

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

Wolfram Language code: errorString; eventFunction[_, "error", error_] := errorString = error tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://exampledata.wolfram.com/50mb.dat", tmpFile, eventFunction, "ReadTimeout" -> 1];
Wolfram Language code: errorString

"ConnectTimeout"  (1)

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

Wolfram Language code: errorString; eventFunction[_, "error", error_] := errorString = error tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; URLSaveAsynchronous["http://127.0.0.1", tmpFile, eventFunction, "ConnectTimeout" -> 1];
Wolfram Language code: errorString

"Progress"  (1)

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

Wolfram Language code: progressData = {};
Wolfram Language code: tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; progressFunction[_, "progress", progress_] := progressData = progress URLSaveAsynchronous["http://exampledata.wolfram.com/5mb.dat", tmpFile, progressFunction, "Progress" -> True]; Dynamic[progressData]

"UserData"  (1)

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

Wolfram Language code: dataString; tmpFile = FileNameJoin[{$TemporaryDirectory, "tmp.txt"}]; eventFunction[async_, "statuscode", data_] := dataString = "UserData" /. Options[async] URLSaveAsynchronous["http://wolfram.com", tmpFile, eventFunction, "UserData" -> "stored data"];
Wolfram Language code: dataString

特性と関係  (1)

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

Wolfram Language code: constitution; f[_, "data", document_] := constitution = FromCharacterCode[document] URLFetchAsynchronous["http://exampledata.wolfram.com/USConstitution.txt", f];
Wolfram Language code: Short[constitution]
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_2026_urlsaveasynchronous, author="Wolfram Research", title="{URLSaveAsynchronous}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html}", note=[Accessed: 30-October-2026]}

BibLaTeX

@online{reference.wolfram_2026_urlsaveasynchronous, organization={Wolfram Research}, title={URLSaveAsynchronous}, year={2012}, url={https://reference.wolfram.com/language/ref/URLSaveAsynchronous.html}, note=[Accessed: 30-October-2026]}