DocumentProperties Classe

Definição

public ref class DocumentProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DocumentProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class DocumentProperties

Public NotInheritable Class DocumentProperties

Herança

Object Platform::Object IInspectable DocumentProperties

Atributos

ContractVersionAttribute

Implementações

IStorageItemExtraProperties

Requisitos do Windows

Exemplos

Este exemplo demonstra como usar uma consulta de arquivo que é apoiada pelo índice do sistema para recuperar propriedades de documento como Title.

try
{
    // Create index backed file query and get results
    List<string> fileTypeFilter = new List<string>();
    fileTypeFilter.Add(".docx");
    QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFileQuery.OrderByName, fileTypeFilter);
    queryOptions.IndexerOption = IndexerOption.OnlyUseIndexer;
    StorageFileQueryResult queryResult = Windows.Storage.KnownFolders.DocumentsLibrary.CreateFileQueryWithOptions(queryOptions);
    var files = await queryResult.GetFilesAsync();

    // Process resulting files
    if (files.Count == 0)
    {
        // Perform tasks to handle no files found
    }
    else
    {
        // Access properties for each file
        foreach (StorageFile file in files)
        {
            var documentProperties = await file.Properties.GetDocumentPropertiesAsync();
            // Perform tasks with document properties
            String title = documentProperties.Title;
        }
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

Embora o exemplo use a DocumentsLibrary para criar a consulta, você pode criar uma consulta como esta para qualquer pasta à qual você tenha acesso que possa obter como uma StorageFolder.

No exemplo, file contém um StorageFile que representa o arquivo para o qual recuperar as propriedades.

Comentários

Você pode acessar um objeto DocumentProperties de forma assíncrona usando o método GetDocumentPropertiesAsync da propriedade Properties de um item (como um arquivo de pasta) ou de forma síncrona usando a propriedade DocumentProperties se ela estiver disponível. Você pode obter um objeto DocumentProperties usando qualquer um dos seguintes métodos e propriedades:

• Propriedade FileInformation.documentProperties
• Propriedade FolderInformation.documentProperties
• Método StorageItemContentProperties.getDocumentPropertiesAsync , que pode ser acessado usando a propriedade Properties , se estiver disponível.

Para obter mais exemplos de código sobre como acessar propriedades, consulte o Exemplo de acesso a arquivos.

Propriedades

Métodos

Aplica-se a

Confira também

• GetDocumentPropertiesAsync()
• DocumentProperties
• DocumentProperties
• DocumentProperties