Return Value
戻り値
The new session download task.
新しいセッションダウンロードタスク。
Discussion
議論
By creating a task based on a request object, you can tune various aspects of the task’s behavior, including the cache policy and timeout interval.
リクエストオブジェクトに基づいてタスクを作成することによって、あなたはタスクのもつ挙動のさまざまな面を調整できます、キャッシュ方針とタイムアウト間隔を含めて。
By using a completion handler, the task bypasses calls to delegate methods for response and data delivery, and instead provides any resulting NSURL
, URLResponse
, and NSError
objects inside the completion handler. Delegate methods for handling authentication challenges, however, are still called.
完了ハンドラを使うことによって、タスクは応答とデータを配達するための委任先メソッドへの呼び出しを迂回します、そして代わりに何らかの結果NSURL
、URLResponse
、そしてNSError
オブジェクトを完了ハンドラ内部で提供します。認証チャレンジを取り扱う委任先メソッドは、しかしながら、依然として呼び出されます。
You should pass a nil
completion handler only when creating tasks in sessions whose delegates include a urlSession(_:downloadTask:didFinishDownloadingTo:)
method.
あなたがnil
完了ハンドラを渡すべきなのは唯一、委任先がurlSession(_:downloadTask:didFinishDownloadingTo:)
メソッドを含むセッションにおいて、それらタスクを作成している時です。
After you create the task, you must start it by calling its resume()
method.
あなたがタスクを作成する後、あなたはそれを、それのresume()
メソッドを呼び出すことによって開始しなければなりません。
If the request completes successfully, the location
parameter of the completion handler block contains the location of the temporary file, and the error
parameter is nil
. If the request fails, the location
parameter is nil
and the error
parameter contain information about the failure. If a response from the server is received, regardless of whether the request completes successfully or fails, the response
parameter contains that information.
リクエストが成功裏に完了するならば、完了ハンドラブロックのlocation
パラメータは一時ファイルの場所を含みます、そしてerror
パラメータはnil
です。リクエストが失敗するならば、location
パラメータはnil
です、そしてerror
パラメータはその失敗についての情報を含みます。サーバからの応答が受け取られるならば、リクエストがうまく完了するか失敗するかどうかに関係なく、response
パラメータはその情報を含みます。