UploadOperation.StartAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking.BackgroundTransfer

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.

Modifica

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

IAsyncOperationWithProgress<UploadOperation,UploadOperation>

Operazione di caricamento asincrona che include gli aggiornamenti dello stato di avanzamento.

Attributi: RemoteAsyncAttribute

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(); });

Si applica a

Condividi tramite