Compartir a través de


UploadOperation.StartAsync Método

Definición

Inicia una operación de carga asincrónica.

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)

Devoluciones

Una operación de carga asincrónica que incluye actualizaciones de progreso.

Atributos

Comentarios

Excepciones

COMException

Se produce cuando se devuelve un HRESULT específico de la característica desde una llamada de método.

Esta es la excepción más común que producen los métodos de red. Una aplicación debe usar HRESULT de la excepción para determinar la causa del error.

AccessDeniedException

Se produce cuando se deniega el acceso a un recurso o a una característica. Esta excepción se produce cuando una aplicación no tiene las funcionalidades de red necesarias establecidas en el manifiesto de la aplicación para la operación de red solicitada.

InvalidArgumentException

Se produce cuando uno de los argumentos que se proporcionan a un método no es válido.

Si la entrada proporcionada por el usuario produjo esta excepción, una aplicación podría informar al usuario y solicitar una nueva entrada.

ObjectDisposedException

Se produce cuando se realiza una operación en un objeto desechado.

OutOfMemoryException

Se produce cuando no hay suficiente memoria disponible para completar la operación.

Se debe programar una operación de carga mediante uno de los métodos BackgroundUploader.CreateUpload, BackgroundUploader.CreateUploadAsync o BackgroundUploader.CreateUploadFromStreamAsync antes de llamar al método StartAsync.

Importante

Poner en cola un gran número de transferencias en el subproceso principal de la interfaz de usuario puede provocar una degradación del rendimiento de la interfaz de usuario de la aplicación, aunque la llamada sea awaitable. Si va a poner en cola un gran número de transferencias, se recomienda llamar a StartAsync en un subproceso de trabajo en segundo plano, como en el ejemplo siguiente.

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

Se aplica a

Consulte también