BasicProperties Classe

Definizione

Fornisce l'accesso alle proprietà di base, ad esempio le dimensioni dell'elemento o la data dell'ultima modifica dell'elemento, dell'elemento (ad esempio un file o una cartella).

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
Ereditarietà
Object Platform::Object IInspectable BasicProperties
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di accesso file illustra come recuperare le proprietà di un file, incluse le proprietà di base, ad esempio 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
}

Al termine di GetBasicPropertiesAsync , basicProperties ottiene un oggetto BasicProperties.

Nell'esempio, file contiene un File di archiviazione che rappresenta il file per cui recuperare le proprietà.

Commenti

È possibile accedere a un oggetto BasicProperties in modo asincrono usando il metodo GetBasicPropertiesAsync di un elemento (ad esempio un file di cartella) o in modo sincrono usando la proprietà BasicProperties se disponibile.

È possibile ottenere un oggetto BasicProperties usando uno dei metodi e delle proprietà seguenti:

Proprietà

DateModified

Ottiene il timestamp dell'ultima volta che il file è stato modificato.

ItemDate

Ottiene la data più rilevante per l'elemento.

Size

Ottiene le dimensioni del file in byte.

Metodi

RetrievePropertiesAsync(IIterable<String>)

Recupera le proprietà specificate associate all'elemento.

SavePropertiesAsync()

Salva tutte le proprietà associate all'elemento.

SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

Salva le proprietà e i valori specificati associati all'elemento.

Si applica a

Vedi anche