Properties | properties-Eigenschaft
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

StorageFile.Properties | properties Property

Ruft ein Objekt ab, das den Zugriff auf die inhaltsbezogenen Eigenschaften der Datei ermöglicht.

Syntax


var properties = storageFile.properties;

Eigenschaftenwert

Typ: StorageItemContentProperties

Das Objekt, das den Zugriff auf die inhaltsbezogenen Eigenschaften der Datei ermöglicht.

Anmerkungen

Hinweis  Auf Eigenschaften, die mit einem Eigenschaftenhandler abgerufen oder festgelegt werden, der von einer anderen App definiert ist (beispielsweise Microsoft Word), kann möglicherweise nicht zugegriffen werden. Stattdessen können Sie versuchen, diese Eigenschaften mit einer Dateiabfrage abzurufen, die durch den Systemindex unterstützt wird. Weitere Informationen finden Sie unter QueryOptions.

Weitere Codebeispiele zum Zugreifen auf Eigenschaften finden Sie unter Dateizugriffsbeispiel.

Windows Phone 8

Diese API wird nicht implementiert und löst beim Aufruf eine Ausnahme aus. Weitere Informationen finden Sie unter Windows Phone Runtime API.

Beispiele

Dieses Beispiel zeigt, wie Inhaltseigenschaften oder angegebene Eigenschaften aus einer Datei mithilfe von StorageFile.Properties abgerufen werden.



var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get image properties
    file.properties.getImagePropertiesAsync().then(function (imageProperties) {
        outputDiv.innerHTML += "Date taken: " + imageProperties.dateTaken + "<br />";
        outputDiv.innerHTML += "Rating: " + imageProperties.rating + "<br />";

        // Specify more properties to retrieve
        var dateAccessedProperty = "System.DateAccessed";
        var fileOwnerProperty    = "System.FileOwner";

        // Get the specified properties through storageFile.properties
        return file.properties.retrievePropertiesAsync([fileOwnerProperty, dateAccessedProperty]);
    }).done(function (extraProperties) {
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "Date accessed: " + propValue + "<br />";
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "File owner: " + propValue;
        }
    },
    // Handle errors with an error function
	   function (error) {
	       // Handle errors encountered while retrieving properties
    });
}

Nach Abschließen von GetImagePropertiesAsync ruft imageProperties ein ImageProperties-Objekt ab. Außerdem ruft extraProperties nach Abschluss von RetrievePropertiesAsync ein Objekt ab, das die angegebenen Eigenschaften enthält.

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

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8

Unterstützte Mindestversion (Server)

Windows Server 2012

Unterstützte Mindestversion (Telefon)

Windows Phone 8 [nicht implementiert, siehe Hinweise]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

Weitere Informationen

StorageFile

 

 

Anzeigen:
© 2018 Microsoft