NSUrlSession クラス

定義

名前空間:

Foundation

アセンブリ:

Xamarin.iOS.dll

大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。

[Foundation.Register("NSURLSession", true)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.iOS, 7, 0, ObjCRuntime.PlatformArchitecture.All, null)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.MacOSX, 10, 9, ObjCRuntime.PlatformArchitecture.All, null)]
public class NSUrlSession : Foundation.NSObject

type NSUrlSession = class
    inherit NSObject

継承

Object

NSObject

NSUrlSession

派生

AVFoundation.AVAssetDownloadUrlSession

属性

RegisterAttribute IntroducedAttribute

注釈

iOS 7 以降では、より大きなファイルを Web との間で転送する場合は、 NSUrlSession 関連するクラスが推奨されます。

NSUrlSession ダウンロードは、アプリケーションがバックグラウンドにある場合に機能します。

通常のタスクとは異なり、バックグラウンド転送は 10 分に制限されず、転送が完了するまで実行されます。 バックグラウンド転送は任意の制限時間に制限されないため、大きなファイルのアップロードやダウンロード、バックグラウンドでのコンテンツの自動更新などを行うことができます。

次の例は、大きなファイルを非同期的にダウンロードできるダウンロード要求を示しています。

var config = NSUrlSessionConfiguration.BackgroundSessionConfiguration(Guid.NewGuid().ToString());
var session = NSUrlSession.FromConfiguration(config, new SimpleSessionDelegate(), new NSOperationQueue());
var downloadTask = session.CreateDownloadTask(NSUrlRequest.FromUrl(url));
//Begin download, asynchronously
downloadTask.Resume();
 ... 
class SimpleSessionDelegate : NSUrlSessionDownloadDelegate
{
  public override void DidFinishDownloading(NSUrlSession session, NSUrlSessionDownloadTask downloadTask, NSUrl location)
	{
		var file = File.OpenRead(location.Path);
     ...
	}
}

コンストラクター

NSUrlSession(IntPtr)	アンマネージド オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
NSUrlSession(NSObjectFlag)	初期化をスキップし、単に オブジェクトを割り当てるために、派生クラスで を呼び出すコンストラクター。

プロパティ

Class	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
ClassHandle	このクラスのハンドル。
Configuration	このセッションの構成オブジェクト。
DebugDescription	このオブジェクトの開発者向けの説明。 (継承元 NSObject)
Delegate	クラス デリゲートとして機能する Foundation.INSUrlSessionDelegate モデル クラスのインスタンス。
DelegateQueue	これが作成されたときに使用される操作キュー。 読み取り専用です。
Description	オブジェクトの説明。Objective-C バージョンの ToString。 (継承元 NSObject)
Handle	アンマネージ オブジェクト表現へのハンドル (ポインター)。 (継承元 NSObject)
IsDirectBinding	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
IsProxy	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
RetainCount	オブジェクトの現在の Objective-C 保持カウントを返します。 (継承元 NSObject)
Self	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
SessionDescription	セッションの人間が判読できる説明。
SharedSession	共有シングルトン オブジェクト。
Superclass	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
SuperHandle	この NSObject の基底クラスのメソッドを表すために使用されるハンドル。 (継承元 NSObject)
WeakDelegate	この型のデリゲート プロトコルに応答できる オブジェクト
Zone	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)

メソッド

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	外部で観察されるオブジェクトを登録します (NSString keyPath を使用)。   観察された変更は、オブザーバーのオブジェクト ObserveValue(NSString, NSObject, NSDictionary, IntPtr) メソッドにディスパッチされます。 (継承元 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	外部で観察されるオブジェクトを登録します (文字列 keyPath を使用)。   観察された変更は、オブザーバーのオブジェクト ObserveValue(NSString, NSObject, NSDictionary, IntPtr) メソッドにディスパッチされます。 (継承元 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	任意のメソッドを使用して外部で観察されるオブジェクトを登録します。 (継承元 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	任意のメソッドを使用して外部で観察されるオブジェクトを登録します。 (継承元 NSObject)
AwakeFromNib()	オブジェクトが nib ファイルから読み込まれた後に呼び出されます。 オーバーライドは base を呼び出す必要があります。AwakeFromNib()。 (継承元 NSObject)
BeginInvokeOnMainThread(Action)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	メイン UI スレッドで指定されたコードを非同期的に呼び出します。 (継承元 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
Bind(String, NSObject, String, NSDictionary)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
BindingInfo(String)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
BindingOptionDescriptions(String)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
BindingValueClass(String)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
CommitEditing()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
ConformsToProtocol(IntPtr)	このオブジェクトが指定されたプロトコルを実装しているかどうかを判断するために呼び出されます。 (継承元 NSObject)
Copy()	基になる Objective-C オブジェクトのコピーを実行します。 (継承元 NSObject)
CreateBidirectionalStream(NSNetService)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateBidirectionalStream(String, nint)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTask(NSUrl)	指定した URL に基づいて HTTP 要求を作成します。
CreateDataTask(NSUrl, NSUrlSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTask(NSUrlRequest)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTask(NSUrlRequest, NSUrlSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTaskAsync(NSUrl)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTaskAsync(NSUrl, NSUrlSessionDataTask)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTaskAsync(NSUrlRequest)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDataTaskAsync(NSUrlRequest, NSUrlSessionDataTask)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTask(NSData)	以前に取り消されたダウンロードまたは失敗したダウンロードのダウンロード タスクを作成します。
CreateDownloadTask(NSUrl)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTask(NSUrl, NSUrlDownloadSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTask(NSUrlRequest)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTask(NSUrlRequest, NSUrlDownloadSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTaskAsync(NSUrl)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTaskAsync(NSUrl, NSUrlSessionDownloadTask)	URL リソースを非同期的に一時ファイルにダウンロードします。
CreateDownloadTaskAsync(NSUrlRequest)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTaskAsync(NSUrlRequest, NSUrlSessionDownloadTask)	URL リソースを非同期的に一時ファイルにダウンロードします。
CreateDownloadTaskFromResumeData(NSData, NSUrlDownloadSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTaskFromResumeDataAsync(NSData)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateDownloadTaskFromResumeDataAsync(NSData, NSUrlSessionDownloadTask)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTask(NSUrlRequest)	アップロード タスクを作成します。
CreateUploadTask(NSUrlRequest, NSData)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTask(NSUrlRequest, NSData, NSUrlSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTask(NSUrlRequest, NSUrl)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTask(NSUrlRequest, NSUrl, NSUrlSessionResponse)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTaskAsync(NSUrlRequest, NSData)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTaskAsync(NSUrlRequest, NSData, NSUrlSessionUploadTask)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTaskAsync(NSUrlRequest, NSUrl)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
CreateUploadTaskAsync(NSUrlRequest, NSUrl, NSUrlSessionUploadTask)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
DangerousAutorelease()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
DangerousRelease()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
DangerousRetain()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	多対多リレーションシップのインデックスに対して変更が発生したことを示します。 (継承元 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
DidChangeValue(String)	指定したキーに変更が発生したことを示します。 (継承元 NSObject)
Dispose()	NSObject オブジェクトによって使用されるリソースを解放します。 (継承元 NSObject)
Dispose(Boolean)	NSObject オブジェクトによって使用されるリソースを解放します。 (継承元 NSObject)
DoesNotRecognizeSelector(Selector)	このオブジェクトが指定したセレクターを認識しないことを示します。 (継承元 NSObject)
Equals(NSObject)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
Equals(Object)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
ExposedBindings()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
FinishTasksAndInvalidate()	未処理のタスクの完了を許可した後、オブジェクトを無効にします。
Flush(Action)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
FlushAsync()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
FromConfiguration(NSUrlSessionConfiguration)	指定した構成から NSUrlSession を作成するファクトリ メソッド。
FromConfiguration(NSUrlSessionConfiguration, INSUrlSessionDelegate, NSOperationQueue)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
FromConfiguration(NSUrlSessionConfiguration, NSUrlSessionDelegate, NSOperationQueue)	古い. 大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
FromWeakConfiguration(NSUrlSessionConfiguration, NSObject, NSOperationQueue)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
GetAllTasks(NSUrlSessionAllPendingTasks)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
GetAllTasksAsync()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
GetBindingInfo(NSString)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetBindingOptionDescriptions(NSString)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetBindingValueClass(NSString)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	指定したキーの値を取得します。 (継承元 NSObject)
GetHashCode()	現在のインスタンスのハッシュ コードを生成します。 (継承元 NSObject)
GetMethodForSelector(Selector)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetNativeField(String)	古い. 大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetNativeHash()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
GetTasks(NSUrlSessionPendingTasks)	古い. 保留中のタスク (データ、アップロード、ダウンロード) のグループを要求します。
GetTasks2(NSUrlSessionPendingTasks2)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
GetTasks2Async()	保留中のタスク (データ、アップロード、ダウンロード) のグループを要求します。
GetTasksAsync()	古い. 保留中のタスク (データ、アップロード、ダウンロード) のグループを要求します。
Init()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
InitializeHandle(IntPtr)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
InitializeHandle(IntPtr, String)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
InvalidateAndCancel()	未処理のすべてのタスクを取り消し、セッション オブジェクトを無効にします。
Invoke(Action, Double)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
Invoke(Action, TimeSpan)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
InvokeOnMainThread(Action)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
InvokeOnMainThread(Selector, NSObject)	メイン UI スレッドで指定したコードを同期的に呼び出します。 (継承元 NSObject)
IsEqual(NSObject)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
IsKindOfClass(Class)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
IsMemberOfClass(Class)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
MarkDirty()	通常のピア オブジェクト (IsDirectBinding が true) を toggleref オブジェクトに昇格させます。 (継承元 NSObject)
MutableCopy()	指定した NSObject の変更可能なコピーを作成します。 (継承元 NSObject)
ObjectDidEndEditing(NSObject)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	このオブジェクトに対する指定された keyPath の相対値が変更されたことを示します。 (継承元 NSObject)
PerformSelector(Selector)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PerformSelector(Selector, NSObject)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PerformSelector(Selector, NSObject, Double)	現在のインスタンスでセレクターを呼び出し、 が null でない場合 obj は、これを 1 つのパラメーターとして渡します。 (継承元 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PerformSelector(Selector, NSObject, NSObject)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
PrepareForInterfaceBuilder()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
RemoveObserver(NSObject, NSString)	指定したオブザーバーが、指定した keyPath の変更された値に関する通知をさらに受信しないようにします。 (継承元 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	指定したオブザーバーが、指定した keyPath とコンテキストの変更された値に関する通知をさらに受信しないようにします。 (継承元 NSObject)
RemoveObserver(NSObject, String)	指定したオブザーバーが、指定した keyPath の変更された値に関する通知をさらに受信しないようにします。 (継承元 NSObject)
RemoveObserver(NSObject, String, IntPtr)	指定したオブザーバーが、指定した keyPath とコンテキストの変更された値に関する通知をさらに受信しないようにします。 (継承元 NSObject)
Reset(Action)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
ResetAsync()	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
RespondsToSelector(Selector)	このオブジェクトが指定したセレクターを認識するかどうか。 (継承元 NSObject)
SetNativeField(String, NSObject)	古い. 大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
SetNilValueForKey(NSString)	指定したキーの値を null に設定します。 (継承元 NSObject)
SetValueForKey(NSObject, NSString)	キーで指定されたプロパティの値を、指定した値に設定します。 (継承元 NSObject)
SetValueForKeyPath(IntPtr, NSString)	アンマネージド オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 (継承元 NSObject)
SetValueForKeyPath(NSObject, NSString)	キーパスを使用して到達できるプロパティの値を設定します。 (継承元 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	未定義のキーに値を書き込もうとすることを示します。 オーバーライドされていない場合は、NSUndefinedKeyException を発生させます。 (継承元 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	この NSObject の値を、指定したディクショナリ内の値に設定します。 (継承元 NSObject)
ToString()	現在のインスタンスの値の文字列表現を返します。 (継承元 NSObject)
Unbind(NSString)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
Unbind(String)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
ValueForKey(NSString)	指定したキーに関連付けられているプロパティの値を返します。 (継承元 NSObject)
ValueForKeyPath(NSString)	キーパスを使用して到達できるプロパティの値を返します。 (継承元 NSObject)
ValueForUndefinedKey(NSString)	未定義のキーの値を読み取ろうとしたことを示します。 オーバーライドされていない場合は、NSUndefinedKeyException を発生させます。 (継承元 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指定したキー内の指定したインデックスの値が変更されようとしていることを示します。 (継承元 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。 (継承元 NSObject)
WillChangeValue(String)	指定したキーの値が変更されようとしていることを示します。 (継承元 NSObject)

拡張メソッド

GetDebugDescription(INSObjectProtocol)	大規模なバックグラウンド タスクを含む、一連のデータ転送タスクを調整します。
GetAccessibilityCustomRotors(NSObject)	オブジェクトに適した オブジェクトの UIAccessibilityCustomRotor 配列を this 取得します。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	オブジェクトに適した オブジェクトの UIAccessibilityCustomRotor 配列を this 設定します。

こちらもご覧ください

• NSUrlSessionTask
• NSUrlRequest
• NSUrlSessionConfiguration
• NSUrlSessionDelegate
• Apple のドキュメント NSURLSession