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

waitsForConnectivity

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

Declaration 宣言 

var waitsForConnectivity: Bool { get set }

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 URLSessionTaskDelegate and waits for connectivity. When connectivity becomes available, the task begins its work and ultimately calls the delegate or completion handler as usual. 相互通信能力は、いくつかの理由から一時的に利用不可になるかもしれません。例えば、あるデバイスは、allowsCellularAccessがfalseに設定される場合にセルラー接続だけしか持たないかもしれません、またはデバイスはVPN接続を要求するしかし利用可能なものが何もないかもしれません。このプロパティの値がtrueであるそして十分な相互通信能力が利用不可であるならば、セッションはURLSessionTaskDelegateのurlSession(_: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 一般プロパティを設定する

var identifier: String?
The background session identifier of the configuration object. 構成設定オブジェクトのバックグラウンドセッション識別子。
var httpAdditionalHeaders: [AnyHashable : Any]?
A dictionary of additional headers to send with requests. リクエストで送られる追加ヘッダそれらからなるある辞書。
var networkServiceType: NSURLRequest.NetworkServiceType
The type of network service for all tasks within sessions based on this configuration. この構成設定に基づくセッションそれら内部の全てのタスクに対するネットワークサービスの型。
var allowsCellularAccess: Bool
A Boolean value that determines whether connections should be made over a cellular network. あるブール値、それは接続がセルラーネットワーク越しになされるべきかどうかを決定します。
var timeoutIntervalForRequest: TimeInterval
The timeout interval to use when waiting for additional data. 追加データを待っているときに使うタイムアウト間隔。
var timeoutIntervalForResource: TimeInterval
The maximum amount of time that a resource request should be allowed to take. リソースリクエストがとるのを許可されるべき最大限の時間量。
var sharedContainerIdentifier: String?
The identifier for the shared container into which files in background URL sessions should be downloaded. それへとバックグラウンドURLセッションにおけるファイルがダウンロードされるべき、共有コンテナに対する識別子。