Platforms to show: All Mac Windows Linux Cross-Platform

NSURLRequestMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Cocoa Networking MBS MacBase Plugin 7.2 ✅ Yes ❌ No ❌ No ✅ Yes All
An NSURLRequest object represents a URL load request in a manner independent of protocol and URL scheme.
Example
msgbox HTMLViewer1.mainFrameMBS.DataSource.Request.url

NSURLRequest encapsulates two basic data elements about a URL load request:

The URL to load.
The policy to use when consulting the URL content cache made available by the implementation.

Constants

Constant Value Description
NSURLRequestReloadIgnoringCacheData 1 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifically, these constants cover interactions that have to do with whether already-existing cache data is returned to satisfy a URL load request. more
NSURLRequestReloadIgnoringLocalAndRemoteCacheData 4 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifies that not only should the local cache data be ignored, but that proxies and other intermediates should be instructed to disregard their caches so far as the protocol allows. more
NSURLRequestReloadRevalidatingCacheData 5 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifies that the existing cache data may be used provided the origin source confirms its validity, otherwise the URL is loaded from the origin source.

Available in Mac OS X v10.5 and later.
NSURLRequestReturnCacheDataDontLoad 3 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifically, these constants cover interactions that have to do with whether already-existing cache data is returned to satisfy a URL load request. more
NSURLRequestReturnCacheDataElseLoad 2 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifically, these constants cover interactions that have to do with whether already-existing cache data is returned to satisfy a URL load request. more
NSURLRequestUseProtocolCachePolicy 0 A constant that can be used to specify the type of interactions that take place with the caching system when the URL loading system processes a request. Specifically, these constants cover interactions that have to do with whether already-existing cache data is returned to satisfy a URL load request. more

Network Service Type Constants

Constant Value Description
NSURLNetworkServiceTypeBackground 3 Specifies that the request is for background traffic (such as a file download).
The service type is used to provide the networking layers a hint of the purpose of the request.
NSURLNetworkServiceTypeDefault 0 Is the default value for an NSURLRequest when created. This value should be left unchanged for the vast majority of requests. more
NSURLNetworkServiceTypeVideo 2 Specifies that the request is for video traffic.
The service type is used to provide the networking layers a hint of the purpose of the request.
NSURLNetworkServiceTypeVoice 4 Specifies that the request is for voice data.
The service type is used to provide the networking layers a hint of the purpose of the request.
NSURLNetworkServiceTypeVoIP 1 Specifies that the request is for voice over IP control traffic.
The service type is used to provide the networking layers a hint of the purpose of the request.

Attribution

Constant Value Description
NSURLRequestAttributionDeveloper 0 Indicates that the URL was specified by the developer. This is the default value for an NSURLRequest when created.
NSURLRequestAttributionUser 1 Indicates that the URL was specified by the user.

Sub classes:

Some methods using this class:

Some properties using for this class:

Some events using this class:

Some examples using this class:

Blog Entries

Xojo Developer Magazine

Release notes


The items on this page are in the following plugins: MBS MacBase Plugin.


NSURLRequestCertificateFilterMBS   -   NSURLResponseMBS


The biggest plugin in space...