UploadOperation Classe

Définition

public ref class UploadOperation sealed : IBackgroundTransferOperationPriority

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UploadOperation final : IBackgroundTransferOperationPriority

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UploadOperation : IBackgroundTransferOperationPriority

Public NotInheritable Class UploadOperation
Implements IBackgroundTransferOperationPriority

Héritage

Object Platform::Object IInspectable UploadOperation

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IBackgroundTransferOperation IBackgroundTransferOperationPriority

Configuration requise pour Windows

Exemples

L’exemple suivant montre comment configurer et commencer une opération de chargement de base.

using Windows.Foundation; 
using Windows.Networking.BackgroundTransfer;
using Windows.Storage.Pickers;
using Windows.Storage;

private async void StartUpload_Click(object sender, RoutedEventArgs e)
{
    try
    {
        Uri uri = new Uri(serverAddressField.Text.Trim());
        FileOpenPicker picker = new FileOpenPicker();
        picker.FileTypeFilter.Add("*");
        StorageFile file = await picker.PickSingleFileAsync();

        BackgroundUploader uploader = new BackgroundUploader();
        uploader.SetRequestHeader("Filename", file.Name);

        UploadOperation upload = uploader.CreateUpload(uri, file);

        // Attach progress and completion handlers.
        HandleUploadAsync(upload, true);
    }
    catch (Exception ex)
    {
        LogException("Upload Error", ex);
    }
}

Remarques

Après l’arrêt de l’application, une application doit énumérer toutes les instances UploadOperation existantes au prochain démarrage à l’aide de GetCurrentUploadsAsync. Lorsqu’une application UWP utilisant le transfert en arrière-plan est terminée, les chargements incomplets sont conservés en arrière-plan. Si l’application est redémarrée après l’arrêt et que ces opérations incomplètes ne sont pas énumérées et réinsérées dans la session active, elles sont obsolètes et continuent d’occuper les ressources de l’appareil. Considérations relatives au délai d’expiration

• 1.) Lors de l’établissement d’une nouvelle connexion pour un chargement via TCP/SSL, la tentative de connexion est abandonnée si elle n’est pas établie dans les cinq minutes.
• 2.) Une fois la connexion établie, un message de requête HTTP qui n’a pas reçu de réponse dans les deux minutes est abandonné. En supposant qu’il existe une connectivité Internet, le transfert en arrière-plan effectue une nouvelle tentative de chargement jusqu’à trois fois. Si la connectivité Internet n’est pas détectée, aucune tentative supplémentaire n’est effectuée tant qu’elle ne l’est pas.

Aide sur le débogage

L’arrêt d’une session de débogage dans Microsoft Visual Studio est comparable à la fermeture de votre application ; Les chargements PUT sont suspendus et les chargements POST sont abandonnés. Même pendant le débogage, votre application doit énumérer, puis suspendre, redémarrer ou annuler les chargements persistants.

Toutefois, si les mises à jour du projet Microsoft Visual Studio, comme les modifications apportées au manifeste de l’application, nécessitent que l’application soit désinstallée et redéployée pour le débogage, GetCurrentUploadsAsync ne peut pas énumérer les opérations persistantes créées à l’aide du déploiement d’application précédent.

Historique des versions

Propriétés

Méthodes

S’applique à

Voir aussi

• Démarrage rapide : Charger un fichier
• Exemple de transfert en arrière-plan
• Exemple de transfert en arrière-plan (Windows 8.x)