Type Method 型メソッド

sendAsynchronousRequest:queue:completionHandler:

Loads the data for a URL request and executes a handler block on an operation queue when the request completes or fails. あるURLリクエストに対してデータをロードして、あるハンドラブロックをある演算キュー上でそのリクエストが完了または失敗する時に実行します。

Declaration 宣言 

+ (void)sendAsynchronousRequest:(NSURLRequest *)request 
                          queue:(NSOperationQueue *)queue 
              completionHandler:(void (^)(NSURLResponse *response, NSData *data, NSError *connectionError))handler;

Parameters パラメータ

request

The URL request to load. The request object is deep-copied as part of the initialization process. Changes made to request after this method returns do not affect the request that is used for the loading process. ロードすることになるURLリクエスト。requestオブジェクトは、初期化処理の一部として深いコピーをされます。このメソッドが返った後にrequestになされる変更は、ロード処理に使われるリクエストに影響を及ぼしません。

queue

The operation queue to which the handler block is dispatched when the request completes or failed. リクエストが完了するまたは失敗した時にそれへとハンドラブロックがディスパッチされる演算キュー。

handler

The handler block to execute. 実行するハンドラブロック。

Discussion 議論

If the request completes successfully, the data parameter of the handler block contains the resource data, and the error parameter is nil. If the request fails, the data parameter is nil and the error parameter contain information about the failure. リクエストがうまく完了するならば、ハンドラブロックのdataパラメータはリソースデータを含みます、そしてerrorパラメータはnilです。リクエストが失敗するならば、dataパラメータはnilです、そしてエラーパラメータは失敗についての情報を含みます。

If authentication is required in order to download the request, the required credentials must be specified as part of the URL. If authentication fails, or credentials are missing, the connection will attempt to continue without credentials. If the request finishes with a 401 Unauthorized status code, the response parameter is nil, the data parameter contains the resource data, and the error parameter is an NSError with the NSURLErrorUserCancelledAuthentication code in the NSURLErrorDomain error domain. 認証がリクエストをダウンロードするために要求されるならば、要求される資格情報はURLの一部として指定されなければなりません。認証が失敗する、または資格情報が見つからないならば、接続は継続を資格情報なしで試みるでしょう。リクエストが401 Unauthorized状態コードで終了するならば、responseパラメータはnilです、dataパラメータはリソースデータを含みます、そしてerrorパラメータはNSURLErrorDomainエラードメインの中のNSURLErrorUserCancelledAuthenticationコードを持つNSErrorを含みます。

See Also 参照

Loading Data Asynchronously データを非同期にロードする

+ connectionWithRequest:delegate:
Creates and returns an initialized URL connection and begins to load the data for the URL request. 初期化されたURL接続を作成して返します、そしてURLリクエストに対してデータのロードを開始します。
Deprecated 非推奨
- initWithRequest:delegate:
Returns an initialized URL connection and begins to load the data for the URL request. 初期化されたURL接続を返します、そしてURLリクエストに対してデータのロードを開始します。
Deprecated 非推奨
- initWithRequest:delegate:startImmediately:
Returns an initialized URL connection and begins to load the data for the URL request, if specified. 初期化されたURL接続を返して、URLリクエストに対してデータのロードを開始します、もし指定されたならば。
Deprecated 非推奨
- start
Causes the connection to begin loading data, if it has not already. 接続にデータのロードを開始させます、もしそれがまだしていないならば。