Class

NSURLSessionDataTask

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

Overview

An NSURLSessionDataTask is a concrete subclass of NSURLSessionTask. The methods in the NSURLSessionDataTask class are documented in NSURLSessionTask.

A data task returns data directly to the app (in memory) as one or more NSData objects. When you use a data task:

For a detailed explanation of this process, read URL Session Programming Guide.

Relationships

Inherits From

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. The task bypasses calls to delegate methods for response and data delivery, and instead provides any resulting NSData, NSURLResponse, and NSError objects inside the completion handler. Delegate methods for handling authentication challenges, however, are still called.

dataTaskWithRequest:

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

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. The task bypasses calls to delegate methods for response and data delivery, and instead provides any resulting NSData, NSURLResponse, and NSError objects inside the completion handler. Delegate methods for handling authentication challenges, however, are still called.

NSURLSessionDataDelegate

The NSURLSessionDataDelegate protocol defines the methods that a delegate of an NSURLSession object can implement to handle task-level events specific to data tasks and upload tasks. Your session delegate should also implement the methods in the NSURLSessionTaskDelegate protocol to handle task-level events that are common to all task types, and methods in the NSURLSessionDelegate protocol to handle session-level events.