UploadOperation.StartAsync Méthode
Définition
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.
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
Opération de chargement asynchrone qui inclut les mises à jour de progression.
- Attributs
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(); });