UploadOperation.StartAsync Méthode

Référence

Définition

Espace de noms:: Windows.Networking.BackgroundTransfer

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Démarre une opération de chargement asynchrone.

public:
 virtual IAsyncOperationWithProgress<UploadOperation ^, UploadOperation ^> ^ StartAsync() = StartAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<UploadOperation, UploadOperation const&> StartAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<UploadOperation,UploadOperation> StartAsync();

function startAsync()

Public Function StartAsync () As IAsyncOperationWithProgress(Of UploadOperation, UploadOperation)

Retours

IAsyncOperationWithProgress<UploadOperation,UploadOperation>

Opération de chargement asynchrone qui inclut les mises à jour de progression.

Attributs: RemoteAsyncAttribute

Remarques

Exceptions

COMException

Levée lorsqu’un HRESULT spécifique à une fonctionnalité est retourné à partir d’un appel de méthode.

Il s’agit de l’exception la plus courante levée par les méthodes réseau. Une application doit utiliser le HRESULT de l’exception pour déterminer la cause de l’erreur.

AccessDeniedException

Levée lorsque l'accès est refusé à une ressource ou à une fonctionnalité. Cette exception se produit lorsqu’une application n’a pas les fonctionnalités réseau requises définies dans le manifeste de l’application pour l’opération réseau demandée.

InvalidArgumentException

Levée lorsque l'un des arguments fournis à une méthode n'est pas valide.

Si l’entrée fournie par l’utilisateur a provoqué cette exception, une application peut informer l’utilisateur et demander une nouvelle entrée.

ObjectDisposedException

Levée lorsqu'une opération est exécutée sur un objet supprimé.

OutOfMemoryException

Levée lorsque la mémoire disponible est insuffisante pour terminer l’opération.

Une opération de chargement doit être planifiée à l’aide de l’une des méthodes BackgroundUploader.CreateUploader, BackgroundUploader.CreateUploadAsync ou BackgroundUploader.CreateUploadFromStreamAsync avant l’appel de la méthode StartAsync.

Important

La mise en file d’attente d’un grand nombre de transferts sur le thread d’interface utilisateur main peut entraîner une dégradation des performances de l’interface utilisateur de votre application, même si l’appel est attendu. Si vous effectuez la file d’attente d’un grand nombre de transferts, il est recommandé d’appeler StartAsync sur un thread de travail en arrière-plan, comme dans l’exemple suivant.

operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });

S’applique à

Partager via