StorageFolder Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Administra las carpetas y su contenido y proporciona información sobre ellas.
public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperationsPublic NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
| Características de aplicaciones |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Comentarios
Normalmente, obtiene objetos StorageFolder como el valor devuelto de las llamadas de método asincrónicas. Por ejemplo, el método estático GetFolderFromPathAsync devuelve una clase StorageFolder que representa la carpeta especificada.
Tenga en cuenta que cuando se llama a un selector de archivos para permitir al usuario elegir una carpeta, el selector de archivos devuelve la carpeta como storageFolder.
Actualmente no hay un método "MoveAsync" o similar. Una implementación sencilla de mover una carpeta podría ser obtener la carpeta deseada, copiarla en la ubicación deseada y, a continuación, eliminar la carpeta original.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1803 | 17134 | TryGetChangeTracker |
| 2004 | 19041 | GetFolderFromPathForUserAsync |
Propiedades
| Attributes |
Obtiene los atributos de la carpeta actual. |
| DateCreated |
Obtiene la fecha y hora en que se creó la carpeta actual. |
| DisplayName |
Obtiene el nombre descriptivo de la carpeta actual. |
| DisplayType |
Obtiene la descripción fácil de usar del tipo de la carpeta; por ejemplo, |
| FolderRelativeId |
Obtiene un identificador para la carpeta actual. Este identificador es único para el resultado de la consulta o StorageFolder que contiene la carpeta o el grupo de archivos actual, y se puede usar para distinguir entre los elementos que tienen el mismo nombre. |
| Name |
Obtiene el nombre de la carpeta actual. |
| Path |
Obtiene la ruta de acceso completa de la carpeta actual en el sistema de archivos, si la ruta de acceso está disponible. |
| Properties |
Obtiene un objeto que proporciona acceso a las propiedades relacionadas con el contenido de la carpeta actual. |
| Provider |
Obtiene el objeto StorageProvider que contiene información sobre el servicio que almacena la carpeta actual. |
Métodos
| AreQueryOptionsSupported(QueryOptions) |
Indica si la carpeta actual admite queryOptions especificada. |
| CreateFileAsync(String) |
Crea un nuevo archivo con el nombre especificado en la carpeta actual. |
| CreateFileAsync(String, CreationCollisionOption) |
Crea un nuevo archivo en la carpeta actual. Este método también especifica qué hacer si ya existe un archivo con el mismo nombre en la carpeta actual. |
| CreateFileQuery() |
Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual. |
| CreateFileQuery(CommonFileQuery) |
Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual. Obtiene también los archivos de las subcarpetas de la carpeta actual cuando el valor del argumento de consulta es algo distinto de CommonFileQuery.DefaultQuery. Los archivos se ordenan en función de CommonFileQuery especificado. |
| CreateFileQueryWithOptions(QueryOptions) |
Obtiene un objeto de resultado de consulta que contiene los archivos de la carpeta actual y, opcionalmente, en las subcarpetas de la carpeta actual. Los resultados se basan en queryOptions especificados. |
| CreateFolderAsync(String) |
Crea una nueva subcarpeta con el nombre especificado en la carpeta actual. |
| CreateFolderAsync(String, CreationCollisionOption) |
Crea una nueva subcarpeta con el nombre especificado en la carpeta actual. Este método también especifica qué hacer si ya existe una subcarpeta con el mismo nombre en la carpeta actual. |
| CreateFolderQuery() |
Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual. |
| CreateFolderQuery(CommonFolderQuery) |
Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es algo distinto de CommonFolderQuery.DefaultQuery, obtiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. Los archivos se agrupan en carpetas en función del valor especificado de la enumeración CommonFolderQuery . |
| CreateFolderQueryWithOptions(QueryOptions) |
Obtiene un objeto de resultado de consulta que contiene las subcarpetas de la carpeta actual y, opcionalmente, subcarpetas anidadas. Los resultados se basan en queryOptions especificados. |
| CreateItemQuery() |
Obtiene un objeto de resultado de consulta que contiene los archivos y subcarpetas de la carpeta actual. |
| CreateItemQueryWithOptions(QueryOptions) |
Obtiene un objeto de resultado de consulta que contiene los archivos y subcarpetas de la carpeta actual y, opcionalmente, en las subcarpetas de la carpeta actual. Los resultados se basan en queryOptions especificados. |
| DeleteAsync() |
Elimina la carpeta actual. |
| DeleteAsync(StorageDeleteOption) |
Elimina la carpeta actual. Este método también especifica si se va a eliminar la carpeta de forma permanente. |
| GetBasicPropertiesAsync() |
Obtiene las propiedades básicas de la carpeta o el grupo de archivos actual. |
| GetFileAsync(String) |
Obtiene el archivo con el nombre especificado de la carpeta actual. |
| GetFilesAsync() |
Obtiene los archivos de la carpeta actual. |
| GetFilesAsync(CommonFileQuery) |
Obtiene los archivos de la carpeta actual. Obtiene también los archivos de las subcarpetas de la carpeta actual cuando el valor del argumento de consulta es algo distinto de CommonFileQuery.DefaultQuery. Los archivos se ordenan según el valor especificado de la enumeración CommonFileQuery . |
| GetFilesAsync(CommonFileQuery, UInt32, UInt32) |
Obtiene un intervalo de archivos basado en índices de la lista de todos los archivos de la carpeta actual. Obtiene también los archivos de las subcarpetas de la carpeta actual cuando el valor del argumento de consulta es algo distinto de CommonFileQuery.DefaultQuery. Los archivos se ordenan según el valor especificado de la enumeración CommonFileQuery . |
| GetFolderAsync(String) |
Obtiene la subcarpeta con el nombre especificado de la carpeta actual. |
| GetFolderFromPathAsync(String) |
Obtiene la carpeta que tiene la ruta de acceso absoluta especificada en el sistema de archivos. |
| GetFolderFromPathForUserAsync(User, String) |
Obtiene StorageFolder en función de una ruta de acceso absoluta en el sistema de archivos para un usuario determinado. |
| GetFoldersAsync() |
Obtiene las subcarpetas de la carpeta actual. |
| GetFoldersAsync(CommonFolderQuery) |
Obtiene las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es algo distinto de CommonFolderQuery.DefaultQuery, obtiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. Los archivos se agrupan en carpetas en función del valor especificado de la enumeración CommonFolderQuery . |
| GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) |
Obtiene un intervalo de carpetas basado en índices de la lista de todas las subcarpetas de la carpeta actual. Cuando el valor del argumento de consulta es algo distinto de CommonFolderQuery.DefaultQuery, obtiene una lista de carpetas virtuales que representan contenedores para grupos de archivos en las subcarpetas de la carpeta actual. Los archivos se agrupan en carpetas en función del valor especificado de la enumeración CommonFolderQuery . |
| GetIndexedStateAsync() |
Obtiene el estado indizado de la carpeta actual. |
| GetItemAsync(String) |
Obtiene el archivo o carpeta con el nombre especificado de la carpeta actual. |
| GetItemsAsync() |
Obtiene los archivos y subcarpetas de la carpeta actual. |
| GetItemsAsync(UInt32, UInt32) |
Obtiene un intervalo de archivos y carpetas basados en índices de la lista de todos los archivos y subcarpetas de la carpeta actual. |
| GetParentAsync() |
Obtiene la carpeta primaria de la carpeta actual. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode) |
Obtiene una imagen escalada como una miniatura, determinada por el propósito de la miniatura. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) |
Obtiene una imagen escalada como una miniatura, determinada por el propósito de la miniatura y el tamaño solicitado. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtiene una imagen escalada como una miniatura, determinada por el propósito de la miniatura, el tamaño solicitado y las opciones especificadas. |
| GetThumbnailAsync(ThumbnailMode) |
Obtiene una imagen en miniatura para la carpeta actual, de tamaño para el propósito especificado de la miniatura. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado. |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtiene una imagen en miniatura para la carpeta actual, con el tamaño especificado de la miniatura y ajustado al tamaño solicitado con las opciones especificadas. |
| IsCommonFileQuerySupported(CommonFileQuery) |
Indica si la carpeta actual admite commonFileQuery especificada. |
| IsCommonFolderQuerySupported(CommonFolderQuery) |
Indica si la carpeta actual admite commonFolderQuery especificada. |
| IsEqual(IStorageItem) |
Indica si la carpeta actual es igual a la carpeta especificada. |
| IsOfType(StorageItemTypes) |
Indica si storageFolder actual coincide con el valor de StorageItemTypes especificado. |
| RenameAsync(String) |
Cambia el nombre de la carpeta actual. |
| RenameAsync(String, NameCollisionOption) |
Cambia el nombre de la carpeta actual y especifica qué hacer si ya existe una carpeta con el mismo nombre. |
| TryGetChangeTracker() |
Obtiene storageLibraryChangeTracker asociado a un objeto StorageFolder. |
| TryGetItemAsync(String) |
Intenta obtener el archivo o la carpeta con el nombre especificado de la carpeta actual. Devuelve null en lugar de generar una excepción FileNotFoundException si no se encuentra el archivo o la carpeta especificados. |