Instance Method

dataTaskWithRequest:

Creates a task that retrieves the contents of a URL based on the specified URL request object.

Declaration

- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request;

Parameters

request

A URL request object that provides request-specific information such as the URL, cache policy, request type, and body data or body stream.

Return Value

The new session data task.

Discussion

By creating a task based on a request object, you can tune various aspects of the task’s behavior, including the cache policy and timeout interval.

After you create the task, you must start it by calling its resume method.

See Also

Adding Data Tasks to a Session

- dataTaskWithURL:

Creates a task that retrieves the contents of the specified URL.

- dataTaskWithURL:completionHandler:

Creates a task that retrieves the contents of the specified URL, then calls a handler upon completion.

- dataTaskWithRequest:completionHandler:

Creates a task that retrieves the contents of a URL based on the specified URL request object, and calls a handler upon completion.

NSURLSessionDataTask

A URL session task that returns downloaded data directly to the app in memory.

NSURLSessionDataDelegate

A protocol defining methods that URL session instances call on their delegates to handle task-level events specific to data and upload tasks.