Instance Method インスタンスメソッド

uploadTask(with:fromFile:)

Creates a task that performs an HTTP request for uploading the specified file. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたファイルをアップロードするために実行します。

Declaration 宣言 

func uploadTask(with request: URLRequest, 
       fromFile fileURL: URL) -> URLSessionUploadTask

Parameters パラメータ

request

A URL request object that provides the URL, cache policy, request type, and so on. The body stream and body data in this request object are ignored. URL、キャッシュ方針、リクエスト型、などを提供するURLリクエストオブジェクト。このリクエストオブジェクトの中のボディストリームとボディデータは、無視されます。

fileURL

The URL of the file to upload. アップロードするファイルのURL。

Return Value 戻り値

The new session upload task. 新しいセッションアップロードタスク。

Discussion 議論

An HTTP upload request is any request that contains a request body, such as a POST or PUT request. Upload tasks require you to create a request object so that you can provide metadata for the upload, like HTTP request headers. HTTPアップロードリクエストは、あるリクエストボディ、たとえばPOSTやPUTリクエストなど、を含んでいる何らかのリクエストです。アップロードタスクは、あなたにリクエストオブジェクトを作成するよう要求します、そうすることであなたはメタデータをそのアップロードに提供できます、HTTPリクエストヘッダのように。

After you create the task, you must start it by calling its resume() method. The task calls methods on the session’s delegate to provide you with the upload’s progress, response metadata, response data, and so on. あなたがタスクを作成する後、あなたはそれを、それのresume()メソッドを呼び出すことによって開始しなければなりません。タスクは、メソッドをセッションのもつ委任先で呼び出して、あなたにアップロードのもつ進捗、応答メタデータ、応答データ、などを提供します。

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, 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リクエストに基づくデータをアップロードするために実行します。
class URLSessionUploadTask
A URL session task that uploads data to the network in a request body. ある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セッションインスタンスがそれらの委任先上で呼び出して、データおよびアップロードタスクに特有なタスク水準イベントを取り扱うものです。