Protocol

URLSessionTaskDelegate

A protocol that defines methods that URL session instances call on their delegates to handle task-level events. あるプロトコル、それはいくつかのメソッドを定義します、それらはURLセッションインスタンスがそれらの委任先上で呼び出してタスク水準イベントを取り扱うものです。

Declaration 宣言 

protocol URLSessionTaskDelegate

Overview 概要

You use this protocol in one of two ways, depending on how you use a URLSession:

  • If you create tasks with Swift’s async-await syntax, using methods like bytes(for:delegate:) and data(for:delegate:), you pass a delegate argument of this type. The delegate receives callbacks for things like task progress, while the call point awaits the completion of the task. あなたがタスクをSwiftのもつasync-await構文で作成する、bytes(for:delegate:)とdata(for:delegate:)のようなメソッドを使っている、ならば、あなたはこの型のdelegate引数を渡します。委任先は、タスク進捗のような事柄に対するコールバックを受け取ります、呼び出しポイントがタスクの完了を待つ間に。

  • If you add tasks to the session with methods like dataTask(with:) and downloadTask(with:), then you implement this protocol’s methods in a delegate you set on the session. This session delegate may also implement other protocols as appropriate, like URLSessionDownloadDelegate and URLSessionDataDelegate. You can also assign a delegate of this type directly to the task to intercept callbacks before the task delivers them to the session’s delegate. あなたはまた、この型の委任先を直接にタスクへと割り当てて、コールバックを横取りすることが、タスクがそれらをセッションのもつ委任先へと配達する前に可能です。

Topics 話題

Handling Task Life Cycle Changes タスクライフサイクル変化を取り扱う

func urlSession(URLSession, task: URLSessionTask, didCompleteWithError: Error?)
Tells the delegate that the task finished transferring data. 委任先に、タスクがデータ転送を終了したことを伝えます。

Handling Redirects リダイレクトを取り扱う

func urlSession(URLSession, task: URLSessionTask, willPerformHTTPRedirection: HTTPURLResponse, newRequest: URLRequest, completionHandler: (URLRequest?) -> Void)
Tells the delegate that the remote server requested an HTTP redirect. 委任先に、リモートサーバがHTTPリダイレクトを要請したことを伝えます。

Working with Upload Tasks アップロードタスクを扱う

func urlSession(URLSession, task: URLSessionTask, didSendBodyData: Int64, totalBytesSent: Int64, totalBytesExpectedToSend: Int64)
Periodically informs the delegate of the progress of sending body content to the server. 定期的に委任先に、ボディ内容のサーバへの送信の進捗を告知します。
func urlSession(URLSession, task: URLSessionTask, needNewBodyStream: (InputStream?) -> Void)
Tells the delegate when a task requires a new request body stream to send to the remote server. 委任先に、タスクが新しいリクエストボディストリームをリモートサーバに送ることを要請する時に伝えます。

Handling Authentication Challenges 認証チャレンジを取り扱う

func urlSession(URLSession, task: URLSessionTask, didReceive: URLAuthenticationChallenge, completionHandler: (URLSession.AuthChallengeDisposition, URLCredential?) -> Void)
Requests credentials from the delegate in response to an authentication request from the remote server. リモートサーバからの認証リクエストに応じて、委任先に資格情報を要請します。
enum URLSession.AuthChallengeDisposition
Constants passed by session or task delegates to the provided continuation block in response to an authentication challenge. ある認証チャレンジへの応答において提供された継続ブロックへと、セッションまたはタスクの委任先によって渡される定数。

Handling Delayed and Waiting Tasks 遅延されたそして待機しているタスクを取り扱う

func urlSession(URLSession, task: URLSessionTask, willBeginDelayedRequest: URLRequest, completionHandler: (URLSession.DelayedRequestDisposition, URLRequest?) -> Void)
Tells the delegate that a delayed URL session task will now begin loading. ある延期されたURLセッションタスクが今ロードを開始することを委任先に伝えます。
enum URLSession.DelayedRequestDisposition
The action to take on a delayed URL session task. ある遅延URLセッションタスクを取ることになるアクション。
func urlSession(URLSession, taskIsWaitingForConnectivity: URLSessionTask)
Tells the delegate that the task is waiting until suitable connectivity is available before beginning the network load. タスクがネットワークロードを開始する前にふさわしい接続性が利用可能になるまで待機していることを委任先に伝えます。

Collecting Task Metrics タスク指標を収集する

func urlSession(URLSession, task: URLSessionTask, didFinishCollecting: URLSessionTaskMetrics)
Tells the delegate that the session finished collecting metrics for the task. 委任先に、セッションがタスクに対する指標を収集し終えたことを伝えます。
class URLSessionTaskMetrics
An object encapsulating the metrics for a session task. あるセッションタスクに対する指標をカプセル化するあるオブジェクト。

Relationships 関係

Inherits From 継承元

Inherited By 継承される先

See Also 参照

Working with a Delegate 委任先を扱う

var delegate: URLSessionDelegate?
The delegate assigned when this object was created. このオブジェクトが作成された時に割り当てられた委任先。
protocol URLSessionDelegate
A protocol that defines methods that URL session instances call on their delegates to handle session-level events, like session life cycle changes. あるプロトコル、それはいくつかのメソッドを定義します、それらはURLセッションインスタンスがそれらの委任先上で呼び出して、セッションライフサイクル変化のようなセッション水準イベントを取り扱うものです。
var delegateQueue: OperationQueue
The operation queue provided when this object was created. このオブジェクトが作成された時に提供されたオペレーションキュー。