ImageProperties Klasse

Referenz

Definition

Namespace:: Windows.Storage.FileProperties

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

StorageItemContentProperties.getImagePropertiesAsync-Methode , auf die mithilfe der Properties-Eigenschaft zugegriffen werden kann, sofern sie verfügbar ist.
FileInformation.imageProperties-Eigenschaft
FolderInformation.imageProperties-Eigenschaft

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:

Freigeben über