UploadOperation.StartAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia uma operação de carregamento assíncrona.
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)Retornos
Uma operação de carregamento assíncrona que inclui atualizações de progresso.
- Atributos
Comentários
Exceções
COMException
Gerado quando um HRESULT específico do recurso é retornado de uma chamada de método.
Essa é a exceção mais comum gerada pelos métodos de rede. Um aplicativo deve usar o HRESULT da exceção para determinar a causa do erro.
AccessDeniedException
Gerada quando o acesso a um recurso é negado. Essa exceção ocorre quando um aplicativo não tem os recursos de rede necessários definidos no manifesto do aplicativo para a operação de rede solicitada.
InvalidArgumentException
Gerada quando um dos argumentos fornecidos a um método não é válido.
Se a entrada fornecida pelo usuário causou essa exceção, um aplicativo poderá informar o usuário e solicitar uma nova entrada.
ObjectDisposedException
Gerada quando uma operação é executada em um objeto descartado.
OutOfMemoryException
Gerado quando a memória insuficiente está disponível para concluir a operação.
Uma operação de upload deve ser agendada usando um dos métodos BackgroundUploader.CreateUpload, BackgroundUploader.CreateUploadAsync ou BackgroundUploader.CreateUploadFromStreamAsync antes que o método StartAsync seja chamado.
Importante
Enfileirar um grande número de transferências no thread de interface do usuário main pode resultar em um desempenho degradado da interface do usuário do aplicativo, mesmo que a chamada seja aguardável. Se você estiver enfileirando um grande número de transferências, é recomendável chamar StartAsync em um thread de trabalho em segundo plano como no exemplo a seguir.
operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });