Protocol

NSURLSessionTaskDelegate

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

Declaration 宣言

@protocol NSURLSessionTaskDelegate

Overview 概要

You use this protocol in one of two ways, depending on how you use a NSURLSession: あなたは、このプロトコルを2つの方法のうちの1つで使います、どのようにあなたがNSURLSessionを使うかに依存して:

  • 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 dataTaskWithURL: and downloadTaskWithURL:, 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 NSURLSessionDownloadDelegate and NSURLSessionDataDelegate. 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. あなたがタスクをセッションにdataTaskWithURL:downloadTaskWithURL:のようなメソッドで加えるならば、そのときあなたはこのプロトコルのもつメソッドを、あなたがそのセッション上で設定するdelegateの中で実装します。このセッション委任先はまた、他のプロトコルをしかるべく実装するかもしれません、NSURLSessionDownloadDelegateNSURLSessionDataDelegateのような。あなたはまた、この型の委任先を直接にタスクへと割り当てて、コールバックを横取りすることが、タスクがそれらをセッションのもつ委任先へと配達する前に可能です。

Topics 話題

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

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

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

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

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

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

See Also 参照

Working with a Delegate 委任先を扱う