Guardar un archivo con un selector

  • Artículo

API importantes

Usa FileSavePicker para permitir a los usuarios especificar el nombre y la ubicación donde desean que tu aplicación guarde un archivo.

Nota

 Para obtener un ejemplo completo, consulta File picker sample (ejemplo de selector de archivos).

Nota:

En una aplicación de escritorio (que incluye aplicaciones WinUI 3), puedes usar selectores de archivos y carpetas de Windows.Storage.Pickers. Sin embargo, si la aplicación de escritorio requiere elevación para ejecutarse, necesitará un enfoque diferente porque estas API no están diseñadas para utilizarse en una aplicación elevada. A modo de ejemplo, vea FileSavePicker.

Requisitos previos

FileSavePicker: paso a paso

Usa FileSavePicker para que los usuarios puedan especificar el nombre, el tipo de archivo y la ubicación de un archivo para guardarlo. Crea, personaliza y muestra un objeto del selector de archivos y luego guarda los datos mediante el objeto StorageFile devuelto, que representa el archivo seleccionado.

  1. Crear y personalizar FileSavePicker

    var savePicker = new Windows.Storage.Pickers.FileSavePicker();
savePicker.SuggestedStartLocation =
    Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.FileTypeChoices.Add("Plain Text", new List<string>() { ".txt" });
// Default file name if the user does not type one in or select a file to replace
savePicker.SuggestedFileName = "New Document";

    Establece las propiedades en el objeto del selector de archivos que sean relevantes para los usuarios y la aplicación. Este ejemplo establece tres propiedades: SuggestedStartLocation, FileTypeChoices y SuggestedFileName.

    • Dado que nuestro usuario está guardando un documento o archivo de texto, la muestra establece SuggestedStartLocation en la carpeta local de la aplicación mediante LocalFolder. Establece SuggestedStartLocation en una ubicación adecuada para el tipo de archivo que se está guardando, por ejemplo, música, imágenes, vídeos o documentos. Desde la ubicación de inicio, el usuario puede dirigirse a otras ubicaciones.

    • Como queremos asegurarnos de que nuestra aplicación puede abrir el archivo después de que este se haya guardado, usaremos FileTypeChoices para especificar los tipos de archivo que admite la muestra (archivos de texto y documentos de Microsoft Word). Procura que todos los tipos de archivo que indiques sean compatibles con tu aplicación. Los usuarios podrán guardar sus archivos como cualquier otro tipo de archivo que especifiques. También pueden cambiar el tipo de archivo seleccionando otro de los tipos de archivo especificados. La primera opción de tipo de archivo de la lista se seleccionará de manera predeterminada: para controlar esto, establece la propiedad DefaultFileExtension.

    Nota

     El selector de archivos usa también el tipo de archivo seleccionado actualmente para filtrar los archivos que se van a mostrar, de modo que el usuario solo podrá ver los tipos de archivo que coincidan con los tipos de archivo seleccionados.

    • Para ahorrar trabajo al usuario, el ejemplo establece un SuggestedFileName. Haz que el nombre de archivo sugerido sea relevante para el archivo que se va a guardar. Por ejemplo, como en Word, puedes sugerir el nombre de archivo existente si solo hay uno, o la primera línea de un documento, si se va a guardar un archivo que aún no tiene nombre.

    Nota

     Los objetos de la clase FileSavePicker muestran el selector de archivos mediante el modo de vista PickerViewMode.List.

  2. Mostrar FileSavePicker y guardarlo en el archivo seleccionado

    Muestra el selector de archivos llamando a PickSaveFileAsync. Cuando el usuario especifique el nombre, el tipo de archivo, la ubicación y confirme que desea guardar el archivo, PickSaveFileAsync devuelve un objeto StorageFile que representa el archivo guardado. Puedes capturar y procesar este archivo ahora que has leído y escrito el acceso a dicho archivo.

    Windows.Storage.StorageFile file = await savePicker.PickSaveFileAsync();
if (file != null)
{
    // Prevent updates to the remote version of the file until
    // we finish making changes and call CompleteUpdatesAsync.
    Windows.Storage.CachedFileManager.DeferUpdates(file);
    // write to file
    await Windows.Storage.FileIO.WriteTextAsync(file, "file contents");
    // Let Windows know that we're finished changing the file so
    // the other app can update the remote version of the file.
    // Completing updates may require Windows to ask for user input.
    Windows.Storage.Provider.FileUpdateStatus status =
        await Windows.Storage.CachedFileManager.CompleteUpdatesAsync(file);
    if (status == Windows.Storage.Provider.FileUpdateStatus.Complete)
    {
        this.textBlock.Text = "File " + file.Name + " was saved.";
    }
    else
    {
        this.textBlock.Text = "File " + file.Name + " couldn't be saved.";
    }
}
else
{
    this.textBlock.Text = "Operation cancelled.";
}

El ejemplo comprueba que el archivo es válido y escribe en él su propio nombre. Consulta también Creación, escritura y lectura de archivos.

Sugerencia

 Siempre debes comprobar el archivo guardado para garantizar que sea válido antes de realizar otros procesos. Luego, puedes guardar contenido en el archivo según corresponda para la aplicación y proporcionar el comportamiento adecuado si el archivo no es válido.

Consulte también

Windows.Storage.Pickers

Archivos, carpetas y bibliotecas

Integración con contratos de selector de archivos

Crear, escribir y leer un archivo