StorageItemContentProperties Classe

Definição

Namespace:

Windows.Storage.FileProperties

Fornece acesso às propriedades relacionadas ao conteúdo de um item (como um arquivo ou pasta).

public ref class StorageItemContentProperties sealed

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

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

Public NotInheritable Class StorageItemContentProperties

Herança

Object Platform::Object IInspectable StorageItemContentProperties

Atributos

ContractVersionAttribute

Implementações

IStorageItemExtraProperties

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo demonstra como recuperar propriedades de conteúdo ou propriedades especificadas de um arquivo usando StorageFile.Properties.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get image properties
        ImageProperties imageProperties = await file.Properties.GetImagePropertiesAsync();
        outputText.AppendLine("Date taken: " + imageProperties.DateTaken);
        outputText.AppendLine("Rating: " + imageProperties.Rating);

        // Specify more properties to retrieve
        readonly string dateAccessedProperty = "System.DateAccessed";
        readonly string fileOwnerProperty = "System.FileOwner";
        List<string> propertiesName = new List<string>();
        propertiesName.Add(dateAccessedProperty);
        propertiesName.Add(fileOwnerProperty);

        // Get the specified properties through StorageFile.Properties
        IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue != null)
        {
            outputText.AppendLine("Date accessed: " + propValue);
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue != null)
        {
            outputText.AppendLine("File owner: " + propValue);
        }
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

Após a conclusão de GetImagePropertiesAsync , imageProperties obtém um objeto ImageProperties . Além disso, após a conclusão de RetrievePropertiesAsync , extraProperties obtém um objeto que contém as propriedades especificadas (a lista de propriedades com suporte pode ser encontrada na página Propriedades principais).

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

Comentários

Você pode obter um objeto StorageItemContentProperties usando a propriedade Properties que está disponível nos seguintes objetos:

• Propriedade StorageFile.Properties
• Propriedade StorageFolder.Properties
• Propriedade FileInformation.Properties
• Propriedade FolderInformation.Properties

Observação

As propriedades que são get ou set usando um manipulador de propriedades definido por outro aplicativo (como o Microsoft Word) podem não estar acessíveis. Em vez disso, você pode tentar obter essas propriedades usando uma consulta de arquivo que é apoiada pelo índice do sistema. Para obter mais informações, consulte QueryOptions.

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

Métodos

GetDocumentPropertiesAsync()	Recupera as propriedades do documento do item (como um arquivo de pasta).
GetImagePropertiesAsync()	Recupera as propriedades de imagem do item (como um arquivo de pasta).
GetMusicPropertiesAsync()	Recupera as propriedades de música do item (como um arquivo de pasta).
GetVideoPropertiesAsync()	Recupera as propriedades de vídeo do item (como um arquivo de pasta).
RetrievePropertiesAsync(IIterable<String>)	Recupera as propriedades especificadas associadas ao item.
SavePropertiesAsync()	Salva todas as propriedades associadas ao item.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	Salva as propriedades e os valores especificados associados ao item.

Confira também

• Página de propriedades principais