UploadOperation.StartAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen asynchronen Uploadvorgang.
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)Gibt zurück
Ein asynchroner Uploadvorgang, der Statusaktualisierungen enthält.
- Attribute
Hinweise
Ausnahmen
COMException
Wird ausgelöst, wenn ein featurespezifisches HRESULT von einem Methodenaufruf zurückgegeben wird.
Dies ist die häufigste Ausnahme, die von Netzwerkmethoden ausgelöst wird. Eine App sollte das HRESULT aus der Ausnahme verwenden, um die Fehlerursache zu ermitteln.
AccessDeniedException
Wird ausgelöst, wenn der Zugriff auf eine Ressource oder eine Funktion verweigert wird. Diese Ausnahme tritt auf, wenn für eine App nicht die erforderlichen Netzwerkfunktionen im App-Manifest für den angeforderten Netzwerkvorgang festgelegt sind.
InvalidArgumentException
Wird ausgelöst, wenn eines der Argumente für eine Methode ungültig ist.
Wenn die vom Benutzer bereitgestellte Eingabe diese Ausnahme verursacht hat, kann eine App den Benutzer informieren und eine neue Eingabe anfordern.
ObjectDisposedException
Wird ausgelöst, wenn ein Vorgang für ein verworfenes Objekt ausgeführt wird.
OutOfMemoryException
Wird ausgelöst, wenn nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs verfügbar ist.
Ein Uploadvorgang muss mit einer der Methoden BackgroundUploader.CreateUpload, BackgroundUploader.CreateUploadAsync oder BackgroundUploader.CreateUploadFromStreamAsync geplant werden, bevor die StartAsync-Methode aufgerufen wird.
Wichtig
Das Anstehen einer großen Anzahl von Übertragungen im Standard UI-Thread kann zu einer Leistungseinbuße der Benutzeroberfläche Ihrer App führen, obwohl der Aufruf abwartbar ist. Wenn Sie eine große Anzahl von Übertragungen anstellen, empfiehlt es sich, StartAsync in einem Hintergrundarbeitsthread aufzurufen, wie im folgenden Beispiel gezeigt.
operation = await Task.Run(() => { return myUploadOperation.StartAsync(); });