Compartilhar via


BasicProperties Classe

Definição

Fornece acesso às propriedades básicas, como o tamanho do item ou a data em que o item foi modificado pela última vez, do item (como um arquivo ou pasta).

public ref class BasicProperties sealed : IStorageItemExtraProperties
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BasicProperties final : IStorageItemExtraProperties
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BasicProperties : IStorageItemExtraProperties
Public NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties
Herança
Object Platform::Object IInspectable BasicProperties
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)

Exemplos

O exemplo de acesso ao arquivo demonstra como recuperar propriedades de um arquivo, incluindo propriedades básicas como Size e DateModified.

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

        // Get basic properties
        BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
        outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
        outputText.AppendLine("Date modified: " + basicProperties.DateModified);

        // 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 GetBasicPropertiesAsync , basicProperties obtém um objeto BasicProperties.

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

Comentários

Você pode acessar um objeto BasicProperties de forma assíncrona usando o método GetBasicPropertiesAsync de um item (como um arquivo de pasta) ou de forma síncrona usando a propriedade BasicProperties se estiver disponível.

Você pode obter um objeto BasicProperties usando qualquer um dos seguintes métodos e propriedades:

Propriedades

DateModified

Obtém o carimbo de data/hora da última vez em que o arquivo foi modificado.

ItemDate

Obtém a data mais relevante para o item.

Size

Obtém o tamanho do arquivo em bytes.

Métodos

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