Instance Property インスタンスプロパティ

waitsForConnectivity

A Boolean value that indicates whether the session should wait for connectivity to become available, or fail immediately. あるブール値、それは相互通信能力が利用可能になるのをセッションが待機するべきか、または直ちに失敗するかを指し示します。

Declaration 宣言

@property BOOL waitsForConnectivity;

Discussion 議論

Connectivity might be temporarily unavailable for several reasons. For example, a device might only have a cellular connection when allowsCellularAccess is set to false, or the device might require a VPN connection but none is available. If the value of this property is true and sufficient connectivity is unavailable, the session calls the URLSession:taskIsWaitingForConnectivity: method of NSURLSessionTaskDelegate and waits for connectivity. When connectivity becomes available, the task begins its work and ultimately calls the delegate or completion handler as usual. 相互通信能力は、いくつかの理由から一時的に利用不可になるかもしれません。例えば、あるデバイスは、allowsCellularAccessfalseに設定される場合にセルラー接続だけしか持たないかもしれません、またはデバイスはVPN接続を要求するしかし利用可能なものが何もないかもしれません。このプロパティの値がtrueであるそして十分な相互通信能力が利用不可であるならば、セッションはNSURLSessionTaskDelegateURLSession:taskIsWaitingForConnectivity:メソッドを呼び出します、そして相互通信能力のために待機します。相互通信能力が利用可能になる場合、タスクはそれの仕事を開始します、そして最後に委任先または完了ハンドラを呼び出します。

If the value of the property is false and connectivity is unavailable, the connection fails immediately with an error, such as NSURLErrorNotConnectedToInternet. プロパティの値がfalseであるそして相互通信能力が利用不可であるならば、接続は直ちにエラー、例えばNSURLErrorNotConnectedToInternetで失敗します。

This property is relevant only during the establishment of a connection. If a connection is established and then drops, the completion handler or delegate receives an error, such as NSURLErrorNetworkConnectionLost. For help dealing with dropped connections, see Handling “The network connection was lost” Errors. このプロパティは、ある接続の確立の間にのみ関係があります。接続が確立されるそしてそれから落ちるならば、完了ハンドラまたは委任先はエラーを受け取ります、たとえばNSURLErrorNetworkConnectionLostなど。落ちた接続を扱う助けとして、Handling “The network connection was lost” Errorsを見てください。

This property is ignored by background sessions, which always wait for connectivity. このプロパティは、バックグラウンドセッションによって無視されます、それは常に相互通信能力に対して待機します。

See Also 参照

Setting General Properties 一般プロパティを設定する