TargetFileRequestDeferral Clase

Definición

Espacio de nombres:

Windows.Storage.Pickers.Provider

Lo usa una aplicación que proporciona una ubicación de guardado para indicar de forma asincrónica que la aplicación ha terminado de responder a un evento TargetFileRequested .

public ref class TargetFileRequestDeferral sealed

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

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

Public NotInheritable Class TargetFileRequestDeferral

Herencia

Object Platform::Object IInspectable TargetFileRequestDeferral

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El ejemplo del selector de archivos muestra cómo responder a un controlador de eventos TargetFileRequested , incluido cómo obtener un aplazamiento.

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

En el ejemplo, e contiene un objeto TargetFileRequestedEventArgs .

Comentarios

Si la aplicación participa en el contrato selector de guardado de archivos y se desencadena un evento TargetFileRequested , la aplicación debe crear un nuevo StorageFile que represente el archivo que el usuario desea guardar. El nombre del storageFile que cree debe coincidir con el nombre del archivo especificado por la propiedad FileName . StorageFile que cree se devuelve a la aplicación que llamó al selector de archivos (la aplicación que realiza la llamada) para que la aplicación que realiza la llamada pueda escribir contenido en el archivo. Obtenga más información sobre cómo responder a este evento en targetFileRequestedEventArgs.

La aplicación, como proveedor de una ubicación de guardado, puede indicar que ha finalizado su respuesta asincrónica a un evento TargetFileRequested llamando a targetFileRequestDeferral.complete. Obtenga más información sobre cómo responder asincrónicamente a un evento TargetFileRequested en TargetFileRequestedEventArgs.

Métodos

Complete()

Indica que la aplicación que proporciona la ubicación de guardado terminó de responder a un evento TargetFileRequested .