ImageProperties Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.FileProperties
Bearbeiten

Ermöglicht den Zugriff auf die bildbezogenen Eigenschaften eines Elements (z. B. eine Datei oder einen Ordner).

public ref class ImageProperties sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ImageProperties final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ImageProperties
Public NotInheritable Class ImageProperties
Vererbung
Object Platform::Object IInspectable ImageProperties
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 Eigenschaften einer Datei abgerufen werden, einschließlich Bildeigenschaften wie DateTaken und Rating.

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);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

Ruft nach Abschluss imagePropertiesvon GetImagePropertiesAsync ein ImageProperties-Objekt ab.

Enthält im Beispiel eine StorageFile-Datei, die die Datei darstellt, file für die Eigenschaften abgerufen werden sollen.

Hinweise

Sie können asynchron auf ein ImageProperties-Objekt zugreifen, indem Sie die getImagePropertiesAsync-Methode über die Properties-Eigenschaft eines Elements (z. B. eine Datei mit einem Ordner) verwenden oder synchron die ImageProperties-Eigenschaft verwenden, wenn sie verfügbar ist. Sie können ein ImageProperties-Objekt mit einer der folgenden Methoden und Eigenschaften abrufen:

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 Zugreifen auf Eigenschaften finden Sie im Dateizugriffsbeispiel.

Eigenschaften

CameraManufacturer

Ruft den Hersteller der Kamera ab, die das Foto aufgenommen hat, oder legt diesen fest.
CameraModel

Ruft das Modell der Kamera ab, die das Foto aufgenommen hat, oder legt es fest.
DateTaken

Ruft das Datum ab, an dem das Bild aufgenommen wurde, oder legt es fest.
Height

Ruft die Höhe des Bilds ab.
Keywords

Ruft die Auflistung von Schlüsselwörtern ab, die dem Bild zugeordnet sind.
Latitude

Ruft die Breitenkoordinate ab, an der das Foto aufgenommen wurde.
Longitude

Ruft die Längengradkoordinate ab, an der das Foto aufgenommen wurde.
Orientation

Ruft das EXIF-Ausrichtungsflag (Exchangeable Image File) des Fotos ab.
PeopleNames

Ruft die Namen von Personen ab, die auf dem Foto markiert sind.
Rating

Ruft die Bewertung ab, die einer Bilddatei zugeordnet ist, oder legt sie fest.
Title

Ruft den Titel des Bilds ab oder legt den Titel fest.
Width

Ruft die Breite des Bilds ab.

Methoden

RetrievePropertiesAsync(IIterable<String>)

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

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

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

Gilt für:

Weitere Informationen