UploadOperation.StartAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia un'operazione di caricamento asincrona.
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)Restituisce
Operazione di caricamento asincrona che include gli aggiornamenti dello stato di avanzamento.
- Attributi
Commenti
Eccezioni
COMException
Generata quando viene restituito un HRESULT specifico della funzionalità da una chiamata al metodo.
Si tratta dell'eccezione più comune generata dai metodi di rete. Un'app deve usare HRESULT dall'eccezione per determinare la causa dell'errore.
AccessDeniedException
Generata quando viene negato l'accesso a una risorsa o a una funzionalità. Questa eccezione si verifica quando un'app non ha le funzionalità di rete necessarie impostate nel manifesto dell'app per l'operazione di rete richiesta.
InvalidArgumentException
Generata quando uno degli argomenti forniti a un metodo non è valido.
Se l'input fornito dall'utente ha causato questa eccezione, un'app potrebbe informare l'utente e richiedere un nuovo input.
ObjectDisposedException
Generata quando viene eseguita un'operazione su un oggetto eliminato.
OutOfMemoryException
Generata quando è disponibile memoria insufficiente per completare l'operazione.
È necessario pianificare un'operazione di caricamento usando uno dei metodi BackgroundUploader.CreateUploader, BackgroundUploader.CreateUploadAsync o BackgroundUploader.CreateUploadFromStreamAsync prima che venga chiamato il metodo StartAsync.
Importante
L'accodamento di un numero elevato di trasferimenti nel thread principale dell'interfaccia utente può comportare una riduzione delle prestazioni dell'interfaccia utente dell'app, anche se la chiamata è awaitable. Se si accoda un numero elevato di trasferimenti, è consigliabile chiamare StartAsync in un thread di lavoro in background come nell'esempio seguente.
operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });