Class

NSMutableURLRequest

A mutable URL load request that bridges to NSURLRequest and you use when you need reference semantics or other Foundation-specific behavior. ある可変URLロードリクエスト、それはNSURLRequestにブリッジします、そしあなたが参照意味論や他のFoundation特有の挙動を必要とする場合は使ってください。

Declaration 宣言

class NSMutableURLRequest : NSURLRequest

Overview 概要

NSMutableURLRequest is a subclass of NSURLRequest that allows you to change the request’s properties. NSMutableURLRequestは、NSURLRequestのサブクラスです、それはあなたにリクエストのもつプロパティを変更させます。

NSMutableURLRequest only represents information about the request. Use other classes, such as URLSession, to send the request to a server. See Fetching Website Data into Memory and Uploading Data to a Website for an introduction to these techniques. NSMutableURLRequestは、リクエストについての情報を表すだけです。他のクラス、たとえばURLSessionを使って、リクエストをサーバーに送信してください。ウェブサイトデータをメモリへと取ってくるとデータをウェブサイトにアップロードするをこれらテクニックに対する導入として見てください。

Classes that create a network operation based on a request make a deep copy of that request. Thus, changing the request after creating a network operation has no effect on the ongoing operation. For example, if you use dataTask(with:completionHandler:) to create a data task from a request, and then later change the request, the data task continues using the original request. リクエストに基づいてあるネットワーク操作を作成するクラスは、そのリクエストの深いコピーを作ります。したがって、ネットワーク操作を作成した後にリクエストを変更することは、進行中の操作に影響しません。例えば、あなたがdataTask(with:completionHandler:)を使ってデータタスクをあるリクエストから作成して、それから後でそのリクエストを変更するならば、データタスクは元のリクエストを使って継続します。

Topics 話題

Working with a Cache Policy キャッシュ方針を扱う

var cachePolicy: NSURLRequest.CachePolicy

The request’s cache policy. その要請のもつキャッシュ方針。

enum NSURLRequest.CachePolicy

The constants used to specify interaction with the cached responses. キャッシュされた応答との相互作用を指定するのに使われる定数。

Accessing Request Components 要請構成要素にアクセスする

var httpMethod: String

The HTTP request method. HTTPリクエストメソッド。

var url: URL?

The URL being requested. 要請されているURL。

var httpBody: Data?

The request body. 要請本文。

var httpBodyStream: InputStream?

The request body as an input stream. 要請本文、入力ストリームとして。

var mainDocumentURL: URL?

The main document URL. メインドキュメントURL。

Accessing Header Fields ヘッダフィールドにアクセスする

var allHTTPHeaderFields: [String : String]?

A dictionary containing all of the HTTP header fields for a request. あるリクエストに対するHTTPヘッダフィールドの全てを含んでいる辞書。

func addValue(String, forHTTPHeaderField: String)

Adds a value to the header field. ある値をヘッダフィールドに加えます。

func setValue(String?, forHTTPHeaderField: String)

Sets a value for the header field. ある値をヘッダフィールドに対して設定します。

Controlling Request Behavior リクエスト挙動を制御する

var timeoutInterval: TimeInterval

The request’s timeout interval, in seconds. この要請のもつ時間切れ間隔、秒で。

var httpShouldHandleCookies: Bool

A Boolean value that indicates whether the request should use the default cookie handling for the request. あるブール値、それは要請が省略時のクッキー処理をその要請に対して使うべきかどうかを指し示します。

var httpShouldUsePipelining: Bool

A Boolean value that indicates whether the request can continue transmitting data before receiving a response from an earlier transmission. あるブール値、それは要請がデータの送信を続けることを以前の送信からの応答を受け取る前に可能かどうかを指し示します。

var allowsCellularAccess: Bool

A Boolean value that indicates whether a connection can use the device’s cellular network (if present). あるブール値、それはある接続がデバイスのセルラーネットワークを使うことができるかどうかを指し示します（もし存在するならば）。

Supporting Limited Modes 制限モードをサポートする

var allowsConstrainedNetworkAccess: Bool

A Boolean value that indicates whether connections may use the network when the user has specified Low Data Mode. ユーザがLow Data Modeを指定する場合に接続がネットワークを使うかもしれないかどうかを指し示すブール値。

var allowsExpensiveNetworkAccess: Bool

A Boolean value that indicates whether connections may use a network interface that the system considers expensive. システムが高くつくと考えるネットワークインターフェイスを接続が使うかもしれないかどうかを指し示すブール値。

Accessing the Service Type サービス型にアクセスする

var networkServiceType: NSURLRequest.NetworkServiceType

The network service type of the connection. この接続のネットワークサービス型。

enum NSURLRequest.NetworkServiceType

Constants that specify how a request uses network resources. どのようにあるリクエストがネットワークリソースを使うかを指定する定数。

Working with Hotspots ホストポートを扱う

func bind(to: NEHotspotHelperCommand)

Binds a URL request to the network interface associated with the hotspot helper command instance. あるURLリクエストをホストポートヘルパーコマンドインスタンスと結び付けられるネットワークインターフェースに束縛します。

Indicating the Source of the Request リスエストのソースを指し示す

var attribution: NSURLRequest.Attribution

The entity that initiates the network request. ネットワークリクエストに着手する実在。

enum NSURLRequest.Attribution

The entities that can make a network request. ネットワークリクエストを作ることが出来る実在。

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

var assumesHTTP3Capable: Bool

Relationships 関係

Inherits From 継承元

NSURLRequest