NSUrlSession Clase

Definición

Espacio de nombres:

Foundation

Ensamblado:

Xamarin.iOS.dll

Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.

[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

Herencia

Object

NSObject

NSUrlSession

Derivado

AVFoundation.AVAssetDownloadUrlSession

Atributos

RegisterAttribute IntroducedAttribute

Comentarios

En iOS 7 y versiones posteriores, NSUrlSession y las clases relacionadas son la manera preferida de transferir archivos más grandes hacia y desde la Web.

NSUrlSession Las descargas pueden funcionar cuando la aplicación está en segundo plano.

A diferencia de las tareas normales, las transferencias en segundo plano no están restringidas a 10 minutos y, en su lugar, se ejecutarán hasta que se complete la transferencia. Dado que las transferencias en segundo plano no están enlazadas por un límite de tiempo arbitrario, se pueden usar para cargar o descargar archivos grandes, actualizar automáticamente el contenido en segundo plano, etc.

En el ejemplo siguiente se muestra una solicitud de descarga, capaz de descargar de forma asincrónica un archivo grande:

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);
     ...
	}
}

Constructores

NSUrlSession(IntPtr)	Constructor utilizado al crear representaciones administradas de objetos no administrados; Lo llama el tiempo de ejecución.
NSUrlSession(NSObjectFlag)	Constructor para llamar a en clases derivadas para omitir la inicialización y simplemente asignar el objeto.

Propiedades

Class	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
ClassHandle	Identificador de esta clase.
Configuration	Objeto de configuración de esta sesión.
DebugDescription	Descripción significativa para el desarrollador de este objeto. (Heredado de NSObject)
Delegate	Instancia de la clase de modelo Foundation.INSUrlSessionDelegate que actúa como delegado de clase.
DelegateQueue	Cola de operaciones usada cuando se creó. Solo lectura.
Description	Descripción del objeto, la versión objective-C de ToString. (Heredado de NSObject)
Handle	Identificador (puntero) a la representación del objeto no administrado. (Heredado de NSObject)
IsDirectBinding	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
IsProxy	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
RetainCount	Devuelve el recuento de retención actual de Objective-C para el objeto . (Heredado de NSObject)
Self	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
SessionDescription	Descripción legible de la sesión.
SharedSession	Objeto singleton compartido.
Superclass	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
SuperHandle	Identificador usado para representar los métodos de la clase base para este NSObject. (Heredado de NSObject)
WeakDelegate	Objeto que puede responder al protocolo delegado de este tipo.
Zone	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)

Métodos

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Registra un objeto para que se observe externamente (mediante NSString keyPath).   Los cambios observados se envían al método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) del observador. (Heredado de NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Registra un objeto para que se observe externamente (mediante keyPath de cadena).   Los cambios observados se envían al método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) del observador. (Heredado de NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra un objeto para que se observe externamente mediante un método arbitrario. (Heredado de NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra un objeto para que se observe externamente mediante un método arbitrario. (Heredado de NSObject)
AwakeFromNib()	Se llama después de cargar el objeto desde el archivo nib. Los invalidadores deben llamar a base. AwakeFromNib(). (Heredado de NSObject)
BeginInvokeOnMainThread(Action)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Invoca de forma asincrónica el código especificado en el subproceso principal de la interfaz de usuario. (Heredado de NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
Bind(String, NSObject, String, NSDictionary)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
BindingInfo(String)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
BindingOptionDescriptions(String)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
BindingValueClass(String)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
CommitEditing()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
ConformsToProtocol(IntPtr)	Se invoca para determinar si este objeto implementa el protocolo especificado. (Heredado de NSObject)
Copy()	Realiza una copia del objeto Objective-C subyacente. (Heredado de NSObject)
CreateBidirectionalStream(NSNetService)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateBidirectionalStream(String, nint)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTask(NSUrl)	Crea una solicitud HTTP basada en la dirección URL especificada.
CreateDataTask(NSUrl, NSUrlSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTask(NSUrlRequest)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTask(NSUrlRequest, NSUrlSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTaskAsync(NSUrl)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTaskAsync(NSUrl, NSUrlSessionDataTask)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTaskAsync(NSUrlRequest)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDataTaskAsync(NSUrlRequest, NSUrlSessionDataTask)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTask(NSData)	Crea una tarea de descarga para una descarga cancelada o errónea previamente.
CreateDownloadTask(NSUrl)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTask(NSUrl, NSUrlDownloadSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTask(NSUrlRequest)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTask(NSUrlRequest, NSUrlDownloadSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTaskAsync(NSUrl)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTaskAsync(NSUrl, NSUrlSessionDownloadTask)	Descarga un recurso de dirección URL de forma asincrónica en un archivo temporal.
CreateDownloadTaskAsync(NSUrlRequest)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTaskAsync(NSUrlRequest, NSUrlSessionDownloadTask)	Descarga un recurso de dirección URL de forma asincrónica en un archivo temporal.
CreateDownloadTaskFromResumeData(NSData, NSUrlDownloadSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTaskFromResumeDataAsync(NSData)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateDownloadTaskFromResumeDataAsync(NSData, NSUrlSessionDownloadTask)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTask(NSUrlRequest)	Crea una tarea de carga.
CreateUploadTask(NSUrlRequest, NSData)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTask(NSUrlRequest, NSData, NSUrlSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTask(NSUrlRequest, NSUrl)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTask(NSUrlRequest, NSUrl, NSUrlSessionResponse)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTaskAsync(NSUrlRequest, NSData)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTaskAsync(NSUrlRequest, NSData, NSUrlSessionUploadTask)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTaskAsync(NSUrlRequest, NSUrl)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
CreateUploadTaskAsync(NSUrlRequest, NSUrl, NSUrlSessionUploadTask)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
DangerousAutorelease()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
DangerousRelease()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
DangerousRetain()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que se ha producido un cambio en los índices de una relación a varios. (Heredado de NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
DidChangeValue(String)	Indica que se ha producido un cambio en la clave especificada. (Heredado de NSObject)
Dispose()	Libera los recursos utilizados por el objeto NSObject. (Heredado de NSObject)
Dispose(Boolean)	Libera los recursos utilizados por el objeto NSObject. (Heredado de NSObject)
DoesNotRecognizeSelector(Selector)	Indica que este objeto no reconoce el selector especificado. (Heredado de NSObject)
Equals(NSObject)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
Equals(Object)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
ExposedBindings()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
FinishTasksAndInvalidate()	Invalida el objeto después de permitir que finalicen las tareas pendientes.
Flush(Action)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
FlushAsync()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
FromConfiguration(NSUrlSessionConfiguration)	Método factory para crear una NSUrlSession a partir de la configuración especificada.
FromConfiguration(NSUrlSessionConfiguration, INSUrlSessionDelegate, NSOperationQueue)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
FromConfiguration(NSUrlSessionConfiguration, NSUrlSessionDelegate, NSOperationQueue)	Obsoletos. Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
FromWeakConfiguration(NSUrlSessionConfiguration, NSObject, NSOperationQueue)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
GetAllTasks(NSUrlSessionAllPendingTasks)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
GetAllTasksAsync()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
GetBindingInfo(NSString)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetBindingOptionDescriptions(NSString)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetBindingValueClass(NSString)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Recupera los valores de las claves especificadas. (Heredado de NSObject)
GetHashCode()	Genera un código hash para la instancia actual. (Heredado de NSObject)
GetMethodForSelector(Selector)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetNativeField(String)	Obsoletos. Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetNativeHash()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
GetTasks(NSUrlSessionPendingTasks)	Obsoletos. Solicita los grupos de tareas pendientes (datos, carga y descargas).
GetTasks2(NSUrlSessionPendingTasks2)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
GetTasks2Async()	Solicita los grupos de tareas pendientes (datos, carga y descargas).
GetTasksAsync()	Obsoletos. Solicita los grupos de tareas pendientes (datos, carga y descargas).
Init()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
InitializeHandle(IntPtr)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
InitializeHandle(IntPtr, String)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
InvalidateAndCancel()	Cancela todas las tareas pendientes e invalida el objeto de sesión.
Invoke(Action, Double)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
Invoke(Action, TimeSpan)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
InvokeOnMainThread(Action)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
InvokeOnMainThread(Selector, NSObject)	Invoca sincrónicamente el código especificado en el subproceso principal de la interfaz de usuario. (Heredado de NSObject)
IsEqual(NSObject)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
IsKindOfClass(Class)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
IsMemberOfClass(Class)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
MarkDirty()	Promueve un objeto del mismo nivel normal (IsDirectBinding es true) en un objeto toggleref. (Heredado de NSObject)
MutableCopy()	Crea una copia mutable del NSObject especificado. (Heredado de NSObject)
ObjectDidEndEditing(NSObject)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Indica que el valor de keyPath especificado en relación con este objeto ha cambiado. (Heredado de NSObject)
PerformSelector(Selector)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PerformSelector(Selector, NSObject)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PerformSelector(Selector, NSObject, Double)	Invoca el selector en la instancia actual y, si no obj es NULL, pasa esto como su único parámetro. (Heredado de NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PerformSelector(Selector, NSObject, NSObject)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
PrepareForInterfaceBuilder()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
RemoveObserver(NSObject, NSString)	Impide que el observador especificado reciba más notificaciones de los valores modificados para keyPath especificado. (Heredado de NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Impide que el observador especificado reciba más notificaciones de valores modificados para el keyPath y el contexto especificados. (Heredado de NSObject)
RemoveObserver(NSObject, String)	Impide que el observador especificado reciba más notificaciones de los valores modificados para keyPath especificado. (Heredado de NSObject)
RemoveObserver(NSObject, String, IntPtr)	Impide que el observador especificado reciba más notificaciones de valores modificados para el keyPath y el contexto especificados. (Heredado de NSObject)
Reset(Action)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
ResetAsync()	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
RespondsToSelector(Selector)	Si este objeto reconoce el selector especificado. (Heredado de NSObject)
SetNativeField(String, NSObject)	Obsoletos. Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
SetNilValueForKey(NSString)	Establece el valor de la clave especificada en NULL. (Heredado de NSObject)
SetValueForKey(NSObject, NSString)	Establece el valor de la propiedad especificada por la clave en el valor especificado. (Heredado de NSObject)
SetValueForKeyPath(IntPtr, NSString)	Constructor utilizado al crear representaciones administradas de objetos no administrados; Lo llama el tiempo de ejecución. (Heredado de NSObject)
SetValueForKeyPath(NSObject, NSString)	Establece el valor de una propiedad que se puede alcanzar mediante una ruta de acceso de clave. (Heredado de NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Indica un intento de escribir un valor en una clave no definida. Si no se reemplaza, genera una excepción NSUndefinedKeyException. (Heredado de NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Establece los valores de este NSObject en los del diccionario especificado. (Heredado de NSObject)
ToString()	Devuelve una representación de cadena del valor de la instancia actual. (Heredado de NSObject)
Unbind(NSString)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
Unbind(String)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
ValueForKey(NSString)	Devuelve el valor de la propiedad asociada a la clave especificada. (Heredado de NSObject)
ValueForKeyPath(NSString)	Devuelve el valor de una propiedad que se puede alcanzar mediante una ruta de acceso de clave. (Heredado de NSObject)
ValueForUndefinedKey(NSString)	Indica un intento de leer un valor de una clave no definida. Si no se reemplaza, genera una excepción NSUndefinedKeyException. (Heredado de NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que los valores de los índices especificados en la clave especificada están a punto de cambiar. (Heredado de NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano. (Heredado de NSObject)
WillChangeValue(String)	Indica que el valor de la clave especificada está a punto de cambiar. (Heredado de NSObject)

Métodos de extensión

GetDebugDescription(INSObjectProtocol)	Coordina un conjunto de tareas de transferencia de datos, incluidas las grandes tareas en segundo plano.
GetAccessibilityCustomRotors(NSObject)	Obtiene la matriz de UIAccessibilityCustomRotor objetos adecuados para this el objeto .
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Establece la matriz de UIAccessibilityCustomRotor objetos apropiados para this el objeto .

Consulte también

• NSUrlSessionTask
• NSUrlRequest
• NSUrlSessionConfiguration
• NSUrlSessionDelegate
• Documentación de Apple para NSURLSession