TargetFileRequest クラス

定義

名前空間:

Windows.Storage.Pickers.Provider

保存場所を提供するアプリで、保存するファイルを表す StorageFile を指定し、アプリが TargetFileRequested イベントに非同期的に応答できるように遅延を取得できるようにします。

public ref class TargetFileRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequest

Public NotInheritable Class TargetFileRequest

継承

Object Platform::Object IInspectable TargetFileRequest

属性

ContractVersionAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

ファイル ピッカーのサンプルでは、Request プロパティを使用して TargetFileRequest を取得する方法など、TargetFileRequested イベント ハンドラーに応答する方法を示します。

// Event handler
private async void OnTargetFileRequested(FileSavePickerUI sender, TargetFileRequestedEventArgs e)
{
    // Respond to TargetFileRequested event on the background thread on which it was raised

    // Requesting a deferral allows the app to call another asynchronous method and complete the request at a later time
    var deferral = e.Request.GetDeferral();

    // Create file and assign to TargetFile property
    e.Request.TargetFile = await ApplicationData.Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption.GenerateUniqueName);

    // Complete the deferral to let the Picker know the request is finished
    deferral.Complete();
}

// Register for the event
fileSavePickerUI.TargetFileRequested += new TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs>(OnTargetFileRequested);

この例では、 eには TargetFileRequestedEventArgs オブジェクトが 含まれています。

注釈

アプリがファイル保存ピッカー コントラクトに参加し、 Targetfilerequested イベントが発生した 場合、アプリは、ユーザーが保存するファイルを表す新しい StorageFile を作成する必要があります。 作成する StorageFile の名前は、 FileName プロパティで指定されたファイルの名前と一致する必要があります。 作成した StorageFile は、呼び出し元アプリがファイルにコンテンツを書き込むことができるように、ファイル ピッカー (呼び出し元アプリ) を呼び出したアプリに返されます。 このイベントへの応答の詳細については、「 TargetFileRequestedEventArgs」を参照してください。

プロパティ

TargetFile

保存場所を提供するアプリによって保存するファイルを表すために提供される IStorageFile オブジェクトを取得または設定します。

メソッド

GetDeferral()

保存場所を提供するアプリが TargetFileRequested イベントに非同期的に応答するために使用できる TargetFileRequestDeferral を取得します。