UploadOperation クラス

定義

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

継承

Object Platform::Object IInspectable UploadOperation

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IBackgroundTransferOperation IBackgroundTransferOperationPriority

Windows の要件

例

次の例では、基本的なアップロード操作を構成して開始する方法を示します。

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

注釈

アプリの終了後、アプリは GetCurrentUploadsAsync を使用して、次回の起動時にすべての既存の UploadOperation インスタンスを列挙する必要があります。 バックグラウンド転送を使用する UWP アプリが終了すると、不完全なアップロードがバックグラウンドで保持されます。 終了後にアプリが再起動され、これらの不完全な操作が列挙されず、現在のセッションに再導入されない場合、それらは古くなり、デバイス リソースを占有し続けます。タイムアウトに関する考慮事項

• 1.) TCP/SSL 経由でアップロードするための新しい接続を確立するときに、接続試行が 5 分以内に確立されていない場合は中止されます。
• 2.) 接続が確立されると、2 分以内に応答を受信していない HTTP 要求メッセージが中止されます。 インターネット接続があると仮定すると、バックグラウンド転送では最大 3 回アップロードが再試行されます。 インターネット接続が検出されない場合、追加の試行は行われません。

デバッグ ガイダンス

Microsoft Visual Studio でのデバッグ セッションの停止は、アプリを閉じるのと同じです。PUT アップロードは一時停止され、POST アップロードは中止されます。 デバッグ中でも、アプリは永続化されたアップロードを列挙してから一時停止、再起動、または取り消す必要があります。

ただし、Microsoft Visual Studio プロジェクトの更新 (アプリ マニフェストの変更など) で、デバッグのためにアプリをアンインストールして再展開する必要がある場合、 GetCurrentUploadsAsync では、前のアプリ展開を使用して作成された永続化された操作を列挙できません。

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• クイック スタート: ファイルをアップロードする
• バックグラウンド転送のサンプル
• バックグラウンド転送のサンプル (Windows 8.x)