FileSavePickerUI.TargetFileRequested イベント

定義

名前空間:

Windows.Storage.Pickers.Provider

ユーザーがファイル ピッカーに保存するファイルをコミットすると発生します。

// Register
event_token TargetFileRequested(TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void TargetFileRequested(event_token const* cookie) const;

// Revoke with event_revoker
FileSavePickerUI::TargetFileRequested_revoker TargetFileRequested(auto_revoke_t, TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<FileSavePickerUI,TargetFileRequestedEventArgs> TargetFileRequested;

function onTargetFileRequested(eventArgs) { /* Your code */ }
fileSavePickerUI.addEventListener("targetfilerequested", onTargetFileRequested);
fileSavePickerUI.removeEventListener("targetfilerequested", onTargetFileRequested);
- or -
fileSavePickerUI.ontargetfilerequested = onTargetFileRequested;

Public Custom Event TargetFileRequested As TypedEventHandler(Of FileSavePickerUI, TargetFileRequestedEventArgs) 

イベントの種類

TypedEventHandler<FileSavePickerUI,TargetFileRequestedEventArgs>

例

ファイル ピッカー のサンプルでは、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 でこのイベントに応答する方法の詳細を確認してください。

注意

指定するアプリがこのイベントへの応答を完了するまで、ファイル ピッカー UI は無効になります。

こちらもご覧ください

• FileSavePickerUI
• TargetFileRequestedEventArgs
• StorageFile