Class

URLSessionUploadTask

A URL session task that uploads data to the network in a request body. あるURLセッションタスク、それはデータをネットワークに、あるリクエストボディにおいてアップロードします。

Declaration 宣言 

class URLSessionUploadTask : URLSessionDataTask

Overview 概要

The URLSessionUploadTask class is a subclass of URLSessionDataTask, which in turn is a concrete subclass of URLSessionTask. The methods associated with the URLSessionUploadTask class are documented in URLSessionTask. URLSessionUploadTaskクラスは、URLSessionDataTaskの具象サブクラスです、それはさらにURLSessionTaskの具象サブクラスです。URLSessionUploadTaskクラスと結びつけられるメソッドは、URLSessionTaskにおいて文書化されます。

Upload tasks are used for making HTTP requests that require a request body (such as POST or PUT). They behave similarly to data tasks, but you create them by calling different methods on the session that are designed to make it easier to provide the content to upload. As with data tasks, if the server provides a response, upload tasks return that response as one or more NSData objects in memory. アップロードタスクは、HTTPリクエストを作るために使われます、それはあるリクエストボディに必要です（例えばPOSTまたはPUT）。それらはデータタスクと同様に振る舞います、しかしあなたはそれらの作成を、セッション上で異なるメソッドそれらを呼び出すことによって行います、それらは内容のアップロードをより簡単にするために設計されます。データタスクでのように、サーバがある応答を提供するならば、アップロードタスクはその応答を１つ以上のNSDataオブジェクトとしてメモリ中に返します。

When you create an upload task, you provide a URLRequest instance that contains any additional headers that you might need to send alongside the upload, such as the content type, content disposition, and so on. In iOS, when you create an upload task for a file in a background session, the system copies that file to a temporary location and streams data from there. あなたがアップロードタスクを作成する場合、あなたはURLRequestインスタンスを提供します、それはあなたがアップロードと一緒に送る必要があるかもしれないあらゆる追加的ヘッダを含みます、たとえばコンテンツタイプ、内容配置、など。iOSでは、あなたがアップロードタスクをあるファイルに対してパックグラウンドセッションにおいて作成する場合、システムはそのファイルを一時的場所にコピーします、そしてデータをそこからストリームします。

While the upload is in progress, the task calls the session delegate’s urlSession(_:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:) method periodically to provide you with status information. アップロードが進行中の場合、タスクはセッション委任先のもつurlSession(_:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:)メソッドを周期的に呼び出すことで、あなたに状態情報を提供します。

When the upload phase of the request finishes, the task behaves like a data task, calling methods on the session delegate to provide you with the server’s response—headers, status code, content data, and so on. リクエストのアップロード段階が終了する場合、タスクはデータタスクのように振る舞います、メソッドをセッション委任先の上で呼び出してあなたにサービスのもつ応答 — ヘッダ、状態コード、内容データ、などを提供します

Topics 話題

Initializers イニシャライザ

init()Deprecated 非推奨

Type Methods 型メソッド

class func new() -> SelfDeprecated 非推奨

Relationships 関係

Inherits From 継承元

See Also 参照

Adding Upload Tasks to a Session アップロードタスクをセッションに加える

func uploadTask(with: URLRequest, from: Data) -> URLSessionUploadTask
Creates a task that performs an HTTP request for the specified URL request object and uploads the provided data. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたURLリクエストオブジェクトに対して実行します、そして提供されたデータをアップロードします。
func uploadTask(with: URLRequest, from: Data?, completionHandler: (Data?, URLResponse?, Error?) -> Void) -> URLSessionUploadTask
Creates a task that performs an HTTP request for the specified URL request object, uploads the provided data, and calls a handler upon completion. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたURLリクエストオブジェクトに対して実行します、そして提供されたデータをアップロードします、そしてあるハンドラを完了に際して呼び出します。
func uploadTask(with: URLRequest, fromFile: URL) -> URLSessionUploadTask
Creates a task that performs an HTTP request for uploading the specified file. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたファイルをアップロードするために実行します。
func uploadTask(with: URLRequest, fromFile: URL, completionHandler: (Data?, URLResponse?, Error?) -> Void) -> URLSessionUploadTask
Creates a task that performs an HTTP request for uploading the specified file, then calls a handler upon completion. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたファイルをアップロードするために実行します、それからあるハンドラを完了に際して呼び出します。
func uploadTask(withStreamedRequest: URLRequest) -> URLSessionUploadTask
Creates a task that performs an HTTP request for uploading data based on the specified URL request. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたURLリクエストに基づくデータをアップロードするために実行します。
protocol URLSessionDataDelegate
A protocol that defines methods that URL session instances call on their delegates to handle task-level events specific to data and upload tasks. あるプロトコル、それはいくつかのメソッドを定義します、それらはURLセッションインスタンスがそれらの委任先上で呼び出して、データおよびアップロードタスクに特有なタスク水準イベントを取り扱うものです。