Partilhar via


StorageFolder Classe

Definição

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, IStorageFolderQueryOperations
Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
Herança
Object Platform::Object IInspectable StorageFolder
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, JPEG image.

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.

Aplica-se a

Confira também