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

uploadTaskWithStreamedRequest:

Creates a task that performs an HTTP request for uploading data based on the specified URL request. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたURLリクエストに基づくデータをアップロードするために実行します。

Declaration 宣言 

- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request;

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, and the session calls its delegate’s URLSession:task:needNewBodyStream: method to provide the body data. URL、キャッシュ方針、リクエスト型、などを提供するURLリクエストオブジェクト。このリクエストオブジェクトの中のボディストリームとボディデータは無視されます、そしてセッションは委任先のもつURLSession:task:needNewBodyStream:メソッドを呼び出すことでボディーデータを提供します。

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 provide a request object so that you can provide metadata for the upload, such as 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. The session’s delegate must have a URLSession:task:needNewBodyStream: method that provides the body data to upload. あなたがタスクを作成する後、あなたはそれを、それのresumeメソッドを呼び出すことによって開始しなければなりません。タスクは、メソッドをセッションのもつ委任先で呼び出して、あなたにアップロードのもつ進捗、応答メタデータ、応答データ、などを提供します。セッションのもつ委任先は、URLSession:task:needNewBodyStream:メソッドを持たなければなりません、それはアップロートするホディデータを提供します。

See Also 参照

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

- uploadTaskWithRequest:fromData:
Creates a task that performs an HTTP request for the specified URL request object and uploads the provided data. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたURLリクエストオブジェクトに対して実行します、そして提供されたデータをアップロードします。
- uploadTaskWithRequest:fromData:completionHandler:
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リクエストオブジェクトに対して実行します、そして提供されたデータをアップロードします、そしてあるハンドラを完了に際して呼び出します。
- uploadTaskWithRequest:fromFile:
Creates a task that performs an HTTP request for uploading the specified file. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたファイルをアップロードするために実行します。
- uploadTaskWithRequest:fromFile:completionHandler:
Creates a task that performs an HTTP request for uploading the specified file, then calls a handler upon completion. あるタスクを作成します、それはあるHTTPリクエストをこの指定されたファイルをアップロードするために実行します、それからあるハンドラを完了に際して呼び出します。
NSURLSessionUploadTask
A URL session task that uploads data to the network in a request body. あるURLセッションタスク、それはデータをネットワークに、あるリクエストボディにおいてアップロードします。
NSURLSessionDataDelegate
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セッションインスタンスがそれらの委任先上で呼び出して、データおよびアップロードタスクに特有なタスク水準イベントを取り扱うものです。