StorageItemContentProperties Classe

Definizione

Spazio dei nomi:

Windows.Storage.FileProperties

Fornisce l'accesso alle proprietà correlate al contenuto di un elemento , ad esempio un file o una cartella.

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

Ereditarietà

Object Platform::Object IInspectable StorageItemContentProperties

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

In questo esempio viene illustrato come recuperare le proprietà del contenuto o le proprietà specificate da un file 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
}

Al termine di GetImagePropertiesAsync , imageProperties ottiene un oggetto ImageProperties . Inoltre, dopo il completamento di RetrievePropertiesAsync , extraProperties ottiene un oggetto che contiene le proprietà specificate. L'elenco delle proprietà supportate è disponibile nella pagina Delle proprietà di base.

Nell'esempio il file contiene un oggetto StorageFile che rappresenta il file per il quale recuperare le proprietà.

Commenti

È possibile ottenere un oggetto StorageItemContentProperties usando la proprietà Properties disponibile negli oggetti seguenti:

• Proprietà StorageFile.Properties
• StorageFolder.Properties - proprietà
• Proprietà FileInformation.Properties
• Proprietà FolderInformation.Properties

Nota

Le proprietà che vengono recuperate o impostate usando un gestore di proprietà definito da un'altra app (ad esempio Microsoft Word) potrebbero non essere accessibili. È invece possibile provare a ottenere queste proprietà usando una query di file supportata dall'indice di sistema. Per altre informazioni, vedere QueryOptions.

Per altri esempi di codice sull'accesso alle proprietà, vedere l'esempio di accesso ai file.

Metodi

GetDocumentPropertiesAsync()	Recupera le proprietà del documento dell'elemento , ad esempio un file di cartella.
GetImagePropertiesAsync()	Recupera le proprietà dell'immagine dell'elemento , ad esempio un file di cartella.
GetMusicPropertiesAsync()	Recupera le proprietà musicali dell'elemento , ad esempio un file di cartella.
GetVideoPropertiesAsync()	Recupera le proprietà video dell'elemento , ad esempio un file di cartella.
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.

Vedi anche

• Pagina delle proprietà di base