StorageItemContentProperties Classe

  • Referência

Definição

Namespace:
Windows.Storage.FileProperties
Editar

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:

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.

Aplica-se a

Confira também