BasicProperties Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.FileProperties

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ContractVersionAttribute

Implementazioni: IStorageItemExtraProperties

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

Condividi tramite