StorageFolder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gerencia pastas e seu conteúdo e fornece informações sobre elas.
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- Herança
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
| Funcionalidades do aplicativo |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
Comentários
Normalmente, você obtém objetos StorageFolder como o valor retornado de chamadas de método assíncrono. Por exemplo, o método estático GetFolderFromPathAsync retorna uma StorageFolder que representa a pasta especificada.
Observe que quando você chama um seletor de arquivos para permitir que o usuário escolha uma pasta, o seletor de arquivos retorna a pasta como um StorageFolder.
Atualmente, não há um método "MoveAsync" ou semelhante. Uma implementação simples de mover uma pasta pode ser obter a pasta desejada, copiá-la para o local desejado e, em seguida, excluir a pasta original.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1803 | 17134 | TryGetChangeTracker |
| 2004 | 19041 | GetFolderFromPathForUserAsync |
Propriedades
| Attributes |
Obtém os atributos da pasta atual. |
| DateCreated |
Obtém a data e a hora em que a pasta atual foi criada. |
| DisplayName |
Obtém o nome amigável da pasta atual. |
| DisplayType |
Obtém a descrição amigável do tipo da pasta; por exemplo, |
| FolderRelativeId |
Obtém um identificador para a pasta atual. Essa ID é exclusiva para o resultado da consulta ou StorageFolder que contém a pasta ou o grupo de arquivos atual e pode ser usada para distinguir entre itens que têm o mesmo nome. |
| Name |
Obtém o nome da pasta atual. |
| Path |
Obtém o caminho completo da pasta atual no sistema de arquivos, se o caminho estiver disponível. |
| Properties |
Obtém um objeto que fornece acesso às propriedades relacionadas ao conteúdo da pasta atual. |
| Provider |
Obtém o objeto StorageProvider que contém informações sobre o serviço que armazena a pasta atual. |
Métodos
| AreQueryOptionsSupported(QueryOptions) |
Indica se a pasta atual dá suporte às QueryOptions especificadas. |
| CreateFileAsync(String) |
Cria um novo arquivo com o nome especificado na pasta atual. |
| CreateFileAsync(String, CreationCollisionOption) |
Cria um novo arquivo na pasta atual. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta atual. |
| CreateFileQuery() |
Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual. |
| CreateFileQuery(CommonFileQuery) |
Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual. Também obtém os arquivos das subpastas da pasta atual quando o valor do argumento de consulta é algo diferente de CommonFileQuery.DefaultQuery. Os arquivos são classificados com base no CommonFileQuery especificado. |
| CreateFileQueryWithOptions(QueryOptions) |
Obtém um objeto de resultado de consulta que contém os arquivos na pasta atual e, opcionalmente, nas subpastas da pasta atual. Os resultados são baseados nas QueryOptions especificadas. |
| CreateFolderAsync(String) |
Cria uma nova subpasta com o nome especificado na pasta atual. |
| CreateFolderAsync(String, CreationCollisionOption) |
Cria uma nova subpasta com o nome especificado na pasta atual. Esse método também especifica o que fazer se uma subpasta com o mesmo nome já existir na pasta atual. |
| CreateFolderQuery() |
Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual. |
| CreateFolderQuery(CommonFolderQuery) |
Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, obtém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. Os arquivos são agrupados em pastas com base no valor especificado da enumeração CommonFolderQuery . |
| CreateFolderQueryWithOptions(QueryOptions) |
Obtém um objeto de resultado de consulta que contém as subpastas na pasta atual e, opcionalmente, subpastas aninhadas. Os resultados são baseados nas QueryOptions especificadas. |
| CreateItemQuery() |
Obtém um objeto de resultado de consulta que contém os arquivos e subpastas na pasta atual. |
| CreateItemQueryWithOptions(QueryOptions) |
Obtém um objeto de resultado de consulta que contém os arquivos e subpastas na pasta atual e, opcionalmente, nas subpastas da pasta atual. Os resultados são baseados nas QueryOptions especificadas. |
| DeleteAsync() |
Exclui a pasta atual. |
| DeleteAsync(StorageDeleteOption) |
Exclui a pasta atual. Esse método também especifica se a pasta deve ser excluída permanentemente. |
| GetBasicPropertiesAsync() |
Obtém as propriedades básicas da pasta ou do grupo de arquivos atual. |
| GetFileAsync(String) |
Obtém o arquivo com o nome especificado da pasta atual. |
| GetFilesAsync() |
Obtém os arquivos na pasta atual. |
| GetFilesAsync(CommonFileQuery) |
Obtém os arquivos na pasta atual. Também obtém os arquivos das subpastas da pasta atual quando o valor do argumento de consulta é algo diferente de CommonFileQuery.DefaultQuery. Os arquivos são classificados com base no valor especificado da enumeração CommonFileQuery . |
| GetFilesAsync(CommonFileQuery, UInt32, UInt32) |
Obtém um intervalo de arquivos baseado em índice da lista de todos os arquivos na pasta atual. Também obtém os arquivos das subpastas da pasta atual quando o valor do argumento de consulta é algo diferente de CommonFileQuery.DefaultQuery. Os arquivos são classificados com base no valor especificado da enumeração CommonFileQuery . |
| GetFolderAsync(String) |
Obtém a subpasta com o nome especificado da pasta atual. |
| GetFolderFromPathAsync(String) |
Obtém a pasta que tem o caminho absoluto especificado no sistema de arquivos. |
| GetFolderFromPathForUserAsync(User, String) |
Obtém o StorageFolder com base em um caminho absoluto no sistema de arquivos para um determinado usuário. |
| GetFoldersAsync() |
Obtém as subpastas na pasta atual. |
| GetFoldersAsync(CommonFolderQuery) |
Obtém as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, obtém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. Os arquivos são agrupados em pastas com base no valor especificado da enumeração CommonFolderQuery . |
| GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) |
Obtém um intervalo de pastas baseado em índice da lista de todas as subpastas na pasta atual. Quando o valor do argumento de consulta é algo diferente de CommonFolderQuery.DefaultQuery, obtém uma lista de pastas virtuais que representam contêineres para grupos de arquivos nas subpastas da pasta atual. Os arquivos são agrupados em pastas com base no valor especificado da enumeração CommonFolderQuery . |
| GetIndexedStateAsync() |
Obtém o estado indexado da pasta atual. |
| GetItemAsync(String) |
Obtém o arquivo ou pasta com o nome especificado da pasta atual. |
| GetItemsAsync() |
Obtém os arquivos e subpastas na pasta atual. |
| GetItemsAsync(UInt32, UInt32) |
Obtém um intervalo baseado em índice de arquivos e pastas da lista de todos os arquivos e subpastas na pasta atual. |
| GetParentAsync() |
Obtém a pasta pai da pasta atual. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode) |
Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) |
Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura e pelo tamanho solicitado. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtém uma imagem dimensionada como uma miniatura, determinada pela finalidade da miniatura, pelo tamanho solicitado e pelas opções especificadas |
| GetThumbnailAsync(ThumbnailMode) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada ao tamanho solicitado. |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
Obtém uma imagem em miniatura para a pasta atual, dimensionada para a finalidade especificada da miniatura e ajustada ao tamanho solicitado com as opções especificadas. |
| IsCommonFileQuerySupported(CommonFileQuery) |
Indica se a pasta atual dá suporte ao CommonFileQuery especificado. |
| IsCommonFolderQuerySupported(CommonFolderQuery) |
Indica se a pasta atual dá suporte ao CommonFolderQuery especificado. |
| IsEqual(IStorageItem) |
Indica se a pasta atual é igual à pasta especificada. |
| IsOfType(StorageItemTypes) |
Indica se o StorageFolder atual corresponde ao valor de StorageItemTypes especificado. |
| RenameAsync(String) |
Renomeia a pasta atual. |
| RenameAsync(String, NameCollisionOption) |
Renomeia a pasta atual e especifica o que fazer se uma pasta com o mesmo nome já existir. |
| TryGetChangeTracker() |
Obtém o StorageLibraryChangeTracker associado a um StorageFolder. |
| TryGetItemAsync(String) |
Tenta obter o arquivo ou a pasta com o nome especificado da pasta atual. Retorna nulo em vez de gerar um FileNotFoundException se o arquivo ou pasta especificado não for encontrado. |