ImageProperties Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.FileProperties

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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

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

Ereditarietà: Object Platform::Object IInspectable ImageProperties

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à di un file, incluse le proprietà dell'immagine, ad esempio DateTaken e 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
}

Al termine di GetImagePropertiesAsync , imageProperties ottiene un oggetto ImageProperties.

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

Commenti

È possibile accedere a un oggetto ImageProperties in modo asincrono usando il metodo getImagePropertiesAsync dalla proprietà Properties di un elemento (ad esempio un file di cartella) o in modo sincrono usando la proprietà ImageProperties , se disponibile. È possibile ottenere un oggetto ImageProperties usando uno dei metodi e delle proprietà seguenti:

Metodo StorageItemContentProperties.getImagePropertiesAsync a cui è possibile accedere tramite la proprietà Properties , se disponibile.
Proprietà FileInformation.imageProperties
Proprietà FolderInformation.imageProperties

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.

Proprietà

CameraManufacturer	Ottiene o imposta il produttore della fotocamera che ha preso la foto.
CameraModel	Ottiene o imposta il modello della fotocamera che ha scattato la foto.
DateTaken	Ottiene o imposta la data in cui è stata acquisita l'immagine.
Height	Ottiene l'altezza dell'immagine.
Keywords	Ottiene la raccolta di parole chiave associate all'immagine.
Latitude	Ottiene la coordinata della latitudine in cui è stata scattata la foto.
Longitude	Ottiene la coordinata di longitudine in cui è stata scattata la foto.
Orientation	Ottiene il flag di orientamento EXIF (Exchangeable Image File) della foto.
PeopleNames	Ottiene i nomi delle persone contrassegnate nella foto.
Rating	Ottiene o imposta la classificazione associata a un file di immagine.
Title	Ottiene o imposta il titolo dell'immagine.
Width	Ottiene la larghezza dell'immagine.

Metodi

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.

Si applica a

Condividi tramite