StorageItemContentProperties Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.FileProperties
Bearbeiten

Bietet Zugriff auf die inhaltsbezogenen Eigenschaften eines Elements (z. B. eine Datei oder einen Ordner).

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
Vererbung
Object Platform::Object IInspectable StorageItemContentProperties
Attribute
ContractVersionAttribute
Implementiert
IStorageItemExtraProperties

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Inhaltseigenschaften oder angegebene Eigenschaften mithilfe von StorageFile.Properties aus einer Datei abgerufen werden.

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
}

Nachdem GetImagePropertiesAsync abgeschlossen wurde, ruft imageProperties ein ImageProperties-Objekt ab. Darüber hinaus ruft extraProperties nach Abschluss von RetrievePropertiesAsync ein Objekt ab, das die angegebenen Eigenschaften enthält (die Liste der unterstützten Eigenschaften finden Sie auf der Seite Core-Eigenschaften).

Im Beispiel enthält die Datei eine StorageFile-Datei , die die Datei darstellt, für die Eigenschaften abgerufen werden sollen.

Hinweise

Sie können ein StorageItemContentProperties-Objekt mithilfe der Properties-Eigenschaft abrufen, die für die folgenden Objekte verfügbar ist:

Hinweis

Auf Eigenschaften, die mithilfe eines Eigenschaftenhandlers abgerufen oder festgelegt werden, der von einer anderen App (z. B. Microsoft Word) definiert wird, kann möglicherweise nicht zugegriffen werden. Stattdessen können Sie versuchen, diese Eigenschaften mithilfe einer Dateiabfrage abzurufen, die vom Systemindex unterstützt wird. Weitere Informationen finden Sie unter QueryOptions.

Weitere Codebeispiele zum Zugriff auf Eigenschaften finden Sie im Dateizugriffsbeispiel.

Methoden

GetDocumentPropertiesAsync()

Ruft die Dokumenteigenschaften des Elements ab (z. B. eine Datei des Ordners).
GetImagePropertiesAsync()

Ruft die Bildeigenschaften des Elements ab (z. B. eine Datei des Ordners).
GetMusicPropertiesAsync()

Ruft die Musikeigenschaften des Elements ab (z. B. eine Datei des Ordners).
GetVideoPropertiesAsync()

Ruft die Videoeigenschaften des Elements ab (z. B. eine Datei des Ordners).
RetrievePropertiesAsync(IIterable<String>)

Ruft die angegebenen Eigenschaften ab, die dem Element zugeordnet sind.
SavePropertiesAsync()

Speichert alle Eigenschaften, die dem Element zugeordnet sind.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind.

Gilt für:

Weitere Informationen