Administrar archivos, carpetas y bibliotecas con Windows App SDK

Windows App SDK proporciona eficaces funcionalidades de administración de archivos para aplicaciones empaquetadas. Puede usar las API de la Windows. Storage, Windows. Storage. Streams y Microsoft.Windows. Storage. Selectores espacios de nombres para leer y escribir de forma eficaz varios formatos de datos en archivos, así como administrar archivos y carpetas.

Hay una amplia variedad de API relacionadas con archivos, carpetas, bibliotecas y configuraciones para aplicaciones de escritorio de Windows a partir de Windows 10. Estas características están disponibles a través de una combinación de Windows App SDK, Windows Runtime (WinRT) y .NET API proporcionadas por las API Windows App SDK, Windows SDK y .NET SDK.

Usar selectores de Windows App SDK para leer y escribir datos

Hay APIs de selección disponibles en el Windows App SDK versión 1.8 y posteriores. En los temas siguientes se proporciona información sobre el uso de las API del selector para permitir que los usuarios abran y guarden archivos y carpetas en la aplicación:

Tema	Description
Abrir archivos y carpetas con selectores en WinUI	Use Windows App SDK selectores de archivos y carpetas para permitir que los usuarios examinen y seleccionen archivos o carpetas en la aplicación WinUI. Las APIs del selector proporcionan una experiencia familiar de Windows que ayuda a los usuarios a navegar por su dispositivo y ubicaciones de almacenamiento en la nube. Obtenga información sobre cómo permitir que los usuarios seleccionen un archivo o una carpeta para abrirlos mediante las clases FileOpenPicker y FolderPicker.
Guardar un archivo con el selector de archivos de Windows App SDK en WinUI	Al compilar aplicaciones WinUI y otras aplicaciones cliente de Windows, los usuarios a menudo necesitan guardar archivos como documentos, imágenes u otro contenido en ubicaciones específicas de su dispositivo. El Windows App SDK proporciona la clase FileSavePicker para crear una interfaz coherente y fácil de usar que permita a los usuarios elegir dónde guardar archivos y qué asignarles nombre.

Diferencias clave entre WinRT y Selectores de Windows App SDK

Estas son algunas diferencias clave de WinRT Windows.Storage.Pickers usados por aplicaciones UWP:

• A diferencia de la API existente Windows.Storage.Pickers, que devuelve los objetos StorageFile y StorageFolder, esta nueva API devuelve rutas basadas en cadenas mediante las clases PickFileResult y PickFolderResult. Esto simplifica la API y evita complicaciones con las funcionalidades de storage en escenarios elevados.
• Del mismo modo, se ha reemplazado la propiedad FileSavePicker.SuggestedSaveFile (que devolvió un StorageFile). Su funcionalidad ahora está cubierta por dos propiedades de cadena: SuggestedFolder y SuggestedFileName. Estos le permiten sugerir el nombre de carpeta y archivo para el cuadro de diálogo guardar.
• Todos los nuevos selectores están diseñados específicamente para aplicaciones de escritorio y usan una propiedad WindowId para vincular el selector a su ventana host, reemplazando el WinRT.Interop.InitializeWithWindow.Initialize patrón.
• Los nuevos selectores permiten a los desarrolladores usarlos sin necesidad de especificar FileTypeFilter o FileTypeChoices. Aunque los selectores de UWP generan excepciones cuando estas propiedades no están configuradas, los nuevos selectores muestran todos los archivos cuando los desarrolladores no configuran explícitamente estas propiedades.
• La ubicación HomeGroup ha sido excluida del nuevo enum PickerLocationId porque dejó de ser compatible a partir de Windows 10.
• FolderPicker.FileTypeFilter se ha excluido porque no era funcionalmente adecuado para la selección de carpetas.
• Excluir métodos y propiedades que ya están marcados como en desuso o "No usar". Por ejemplo, PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, etc.
• Excluyendo métodos y propiedades para el modo multiusuario, ya que las nuevas API están diseñadas actualmente para escenarios de escritorio en los que cada usuario tiene su propia sesión interactiva y cada sesión es completamente independiente de las demás sesiones del dispositivo. Esto contrasta con Xbox u otros dispositivos multiusuario.

Acceder a los datos con las API de almacenamiento de WinRT

Las aplicaciones empaquetadas tienen acceso a todas las API de almacenamiento WinRT disponibles para las aplicaciones UWP. Tanto si va a migrar una aplicación para UWP existente como si va a crear una aplicación, puede usar estas API para leer y escribir datos. Para obtener ejemplos de uso de las API de almacenamiento en una aplicación WinUI 3, consulte Acceder a archivos y carpetas con el SDK de aplicaciones de Windows y las API de WinRT.

Utilice las API de archivos de .NET para el acceso a datos

Además de las API de WinRT, las aplicaciones de escritorio empaquetadas pueden usar las API de .NET en el espacio de nombres System.IO para leer y escribir datos. Cuando se crea un nuevo proyecto WinUI, su archivo Package.appxmanifest contiene la siguiente configuración:

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

Declarar esta capacidad restringida proporciona acceso completo al sistema de archivos, al registro y a otras capacidades restringidas. Para obtener más información, consulta Declaraciones de funcionalidad restringida. En otras palabras, la aplicación tiene el mismo access al sistema de archivos que cualquier otra aplicación de escritorio .NET al usar las API de archivo de .NET.

Para obtener ejemplos de uso de las API de .NET en una aplicación WinUI, consulte Acceda a archivos y carpetas con Windows App SDK y APIs de .NET.

Recursos adicionales para trabajar con archivos y carpetas

Si está desarrollando aplicaciones WinUI empaquetadas, las API de Storage WinRT pueden ser una herramienta eficaz para leer y escribir datos. Los siguientes temas de UWP proporcionan una gran cantidad de información para los desarrolladores que buscan aprovechar estas API en sus aplicaciones.

Tema	Description
Enumerar y consultar archivos y carpetas	Accede a archivos y carpetas en una carpeta, biblioteca, dispositivo o ubicación de red. También puede consultar los archivos y carpetas en una ubicación mediante la construcción de consultas de archivos y carpetas.
Creación, escritura y lectura de un archivo	Lee y escribe un archivo mediante un objeto StorageFile.
Procedimientos recomendados para escribir en archivos	Obtenga información sobre los procedimientos recomendados para usar varios métodos de escritura de archivos de las clases FileIO y PathIO.
Obtener propiedades de archivo	Obtiene propiedades (nivel superior, básico y extendido) para un archivo representado por un objeto StorageFile.
Acceso al contenido del grupo hogar	Accede al contenido almacenado en la carpeta "HomeGroup" del usuario, incluidas imágenes, música y vídeos.
Determinando la disponibilidad de archivos de Microsoft OneDrive	Determine si hay disponible un archivo Microsoft OneDrive mediante la propiedad StorageFile.IsAvailable.
Archivos y carpetas en las bibliotecas Música, Imágenes y Vídeos	Agregue carpetas existentes de música, imágenes o vídeos a las bibliotecas correspondientes. También puede quitar carpetas de bibliotecas, obtener la lista de carpetas de una biblioteca y detectar fotos almacenadas, música y vídeos.
Seguimiento de archivos y carpetas usados recientemente	Realice un seguimiento de los archivos a los que el usuario accede con frecuencia agregándolos a la lista usada más recientemente de la aplicación (MRU). La plataforma administra el MRU automáticamente ordenando los elementos en función de cuándo se accedió por última vez y quitando el elemento más antiguo cuando se alcanza el límite de 25 elementos de la lista. Todas las aplicaciones tienen su propia MRU.
Seguimiento de los cambios del sistema de archivos en segundo plano	Realice un seguimiento de los cambios en el sistema de archivos, incluso cuando la aplicación no se esté ejecutando.
Access la tarjeta SD	Puede almacenar datos no esenciales y acceder a ellos en una tarjeta microSD opcional, especialmente en dispositivos móviles de bajo costo que tienen almacenamiento interno limitado.
Acceso rápido a las propiedades del archivo	Recopile de forma eficaz una lista de archivos y sus propiedades de una biblioteca para usarlas a través de las API de Windows Runtime.

Consulte también

Acceder a archivos y carpetas con Windows App SDK y las APIs de WinRT

Accede a los archivos y las carpetas con Windows App SDK y las API de .NET

System.IO