ImageProperties Класс

Определение

Пространство имен:

Windows.Storage.FileProperties

Предоставляет доступ к свойствам, связанным с изображением элемента (например, к файлу или папке).

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

Наследование

Object Platform::Object IInspectable ImageProperties

Атрибуты

ContractVersionAttribute

Реализации

IStorageItemExtraProperties

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере показано, как получить свойства файла, включая свойства изображения, такие как DateTaken и 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
}

После завершения imagePropertiesgetImagePropertiesAsync получает объект ImageProperties.

В этом примере содержит storageFile, представляющий файл, file для которого извлекаются свойства.

Комментарии

Получить доступ к объекту ImageProperties можно асинхронно с помощью метода getImagePropertiesAsync из свойства Properties элемента (например, файла папки) или синхронно с помощью свойства ImageProperties , если оно доступно. Объект ImageProperties можно получить с помощью любого из следующих методов и свойств:

• Метод StorageItemContentProperties.getImagePropertiesAsync , доступ к которому можно получить с помощью свойства Properties , если он доступен.
• Свойство FileInformation.imageProperties
• Свойство FolderInformation.imageProperties

Примечание

Свойства, которые получаются или задаются с помощью обработчика свойств, определенного другим приложением (например, Microsoft Word), могут быть недоступны. Вместо этого можно попытаться получить эти свойства с помощью запроса файла, который поддерживается системным индексом. Дополнительные сведения см. в разделе QueryOptions.

Дополнительные примеры кода о доступе к свойствам см. в разделе Пример доступа к файлам.

Свойства

CameraManufacturer	Возвращает или задает производителя камеры, которая сделала фотографию.
CameraModel	Возвращает или задает модель камеры, которая сделала фотографию.
DateTaken	Возвращает или задает дату создания изображения.
Height	Возвращает высоту изображения.
Keywords	Возвращает коллекцию ключевых слов, связанных с изображением.
Latitude	Возвращает координату широты, в которой была сделана фотография.
Longitude	Возвращает координату долготы, в которой была сделана фотография.
Orientation	Возвращает флаг ориентации exif фотографии.
PeopleNames	Возвращает имена людей, помеченных на фотографии.
Rating	Возвращает или задает оценку, связанную с файлом изображения.
Title	Возвращает или задает заголовок изображения.
Width	Возвращает ширину изображения.

Методы

RetrievePropertiesAsync(IIterable<String>)	Извлекает указанные свойства, связанные с элементом.
SavePropertiesAsync()	Сохраняет все свойства, связанные с элементом.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	Сохраняет указанные свойства и значения, связанные с элементом.

См. также раздел

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties