InPlaceBitmapMetadataWriter Класс

Определение

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

System.Windows.Media.Imaging

Сборка:

PresentationCore.dll

Позволяет выполнять обновления на месте для существующих блоков BitmapMetadata.

public ref class InPlaceBitmapMetadataWriter sealed : System::Windows::Media::Imaging::BitmapMetadata

public sealed class InPlaceBitmapMetadataWriter : System.Windows.Media.Imaging.BitmapMetadata

type InPlaceBitmapMetadataWriter = class
    inherit BitmapMetadata

Public NotInheritable Class InPlaceBitmapMetadataWriter
Inherits BitmapMetadata

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

Object

DispatcherObject

DependencyObject

Freezable

ImageMetadata

BitmapMetadata

InPlaceBitmapMetadataWriter

Примеры

В этом примере показано, как можно изменить метаданные в изображении без необходимости повторного кодирования изображения. В следующем примере используется InPlaceBitmapMetadataWriter для записи метаданных в изображение.

Stream^ pngStream = gcnew FileStream("smiley.png", FileMode::Open, FileAccess::ReadWrite, FileShare::ReadWrite);
PngBitmapDecoder^ pngDecoder = gcnew PngBitmapDecoder(pngStream, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapFrame^ pngFrame = pngDecoder->Frames[0];
InPlaceBitmapMetadataWriter^ pngInplace = pngFrame->CreateInPlaceBitmapMetadataWriter();
if (pngInplace->TrySave() == true)
{
   pngInplace->SetQuery("/Text/Description", "Have a nice day.");
}
pngStream->Close();

Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();

Dim pngStream As New System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite)
Dim pngDecoder As New PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim pngFrame As BitmapFrame = pngDecoder.Frames(0)
Dim pngInplace As InPlaceBitmapMetadataWriter = pngFrame.CreateInPlaceBitmapMetadataWriter()
If pngInplace.TrySave() = True Then
    pngInplace.SetQuery("/Text/Description", "Have a nice day.")
End If
pngStream.Close()

Комментарии

Если BitmapMetadata не связан с BitmapFrame объектом , полученным с помощью BitmapDecoder, попытка записи метаданных с помощью модуля записи на месте завершится ошибкой. Успешные операции записи применяют метаданные непосредственно к потоку изображений с помощью декодера.

Обновление метаданных на месте завершается ошибкой, если предпринята попытка записать метаданные, которые не поддерживаются заданным форматом растрового изображения.

Для редактирования метаданных на месте растровое изображение должно быть декодировано с помощью параметров кэша Default или OnDemand . OnLoad не гарантирует доступ к потоку метаданных, необходимому для редактирования метаданных на месте.

Свойства

ApplicationName	Получает или задает значение, указывающее имя приложения, которое использовалось для создания или изменения файла изображения. (Унаследовано от BitmapMetadata)
Author	Получает или задает значение, представляющее автора изображения. (Унаследовано от BitmapMetadata)
CameraManufacturer	Получает или задает значение, указывающее производителя камеры, связанного с изображением. (Унаследовано от BitmapMetadata)
CameraModel	Возвращает или задает значение, указывающее модель камеры, которая использовалась для создания изображения. (Унаследовано от BitmapMetadata)
CanFreeze	Возвращает значение, которое указывает, можно ли сделать объект неизменяемым. (Унаследовано от Freezable)
Comment	Получает или задает значение, представляющее комментарий, связанный с файлом изображения. (Унаследовано от BitmapMetadata)
Copyright	Получает или задает значение, которое указывает информацию об авторских правах, связанную с файлом изображения. (Унаследовано от BitmapMetadata)
DateTaken	Получает или задает значение, указывающее дату, когда было получено изображение. (Унаследовано от BitmapMetadata)
DependencyObjectType	Возвращает объект DependencyObjectType , который заключает в оболочку тип среды CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
Format	Возвращает значение, указывающее формат изображения. (Унаследовано от BitmapMetadata)
IsFixedSize	Получает значение, определяющее, имеет ли объект BitmapMetadata фиксированный размер. (Унаследовано от BitmapMetadata)
IsFrozen	Получает значение, указывающее, доступен ли объект для изменения в настоящее время. (Унаследовано от Freezable)
IsReadOnly	Получает значение, указывающее, доступны ли метаданные, сопоставленные с изображением, только для чтения. (Унаследовано от BitmapMetadata)
IsSealed	Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). (Унаследовано от DependencyObject)
Keywords	Возвращает или задает коллекцию ключевых слов, описывающих растровое изображение. (Унаследовано от BitmapMetadata)
Location	Получает значение, идентифицирующее базовое расположение метаданных, связанных с изображением. (Унаследовано от BitmapMetadata)
Rating	Возвращает или задает значение, указывающее оценку изображения. (Унаследовано от BitmapMetadata)
Subject	Получает или задает значение, указывающее тематику точечного рисунка. (Унаследовано от BitmapMetadata)
Title	Получает или задает значение, указывающее название файла изображения. (Унаследовано от BitmapMetadata)

Методы

CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty. (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает изменяемый клон данного объекта InPlaceBitmapMetadataWriter, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения.
CloneCore(Freezable)	Делает этот экземпляр глубокой копией указанного объекта BitmapMetadata. (Унаследовано от BitmapMetadata)
CloneCurrentValue()	Создает редактируемую копию (глубокую копию) объекта Freezable с использованием его текущих значений. (Унаследовано от Freezable)
CloneCurrentValueCore(Freezable)	Делает этот экземпляр изменяемой глубокой копией указанной коллекции BitmapMetadata с использованием текущих значений свойств. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения. (Унаследовано от BitmapMetadata)
CoerceValue(DependencyProperty)	Приводит значение указанного свойства зависимостей. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. (Унаследовано от DependencyObject)
ContainsQuery(String)	Определяет, существует ли в указанная строка запроса в объекте BitmapMetadata. (Унаследовано от BitmapMetadata)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	Реализация метода CreateInstance(). (Унаследовано от BitmapMetadata)
Equals(Object)	Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и присваивает его свойству IsFrozen значение true. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает объект Freezable нередактируемым или проверяет, можно ли его сделать нередактируемым. (Унаследовано от Freezable)
GetAsFrozen()	Создает фиксированную копию объекта Freezable, используя базовые (не анимационные) значения свойств. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает этот экземпляр клоном указанного объекта BitmapMetadata. (Унаследовано от BitmapMetadata)
GetCurrentValueAsFrozen()	Создает фиксированную копию объекта Freezable с использованием текущих значений свойств. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает этот экземпляр зафиксированным клоном указанного объекта BitmapMetadata. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения. (Унаследовано от BitmapMetadata)
GetHashCode()	Возвращает хэш-код для данного объекта DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject. (Унаследовано от DependencyObject)
GetQuery(String)	Предоставляет доступ к модулю чтения запроса метаданных, который может извлекать метаданные из файла растрового изображения. (Унаследовано от BitmapMetadata)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет действующее значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего объекта Freezable. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет реализацию DependencyObject для OnPropertyChanged(DependencyPropertyChangedEventArgs), чтобы также вызвать любой обработчик Changed в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если таковое существует. (Унаследовано от DependencyObject)
ReadPreamble()	Обеспечивает доступ к Freezable из допустимого потока. Наследники объекта Freezable должны вызывать данный метод в начале любого API, который считывает элементы данных, не являющиеся свойствами зависимостей. (Унаследовано от Freezable)
RemoveQuery(String)	Удаляет запрос метаданных из экземпляра BitmapMetadata. (Унаследовано от BitmapMetadata)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не меняя источник значения. (Унаследовано от DependencyObject)
SetQuery(String, Object)	Предоставляет доступ к модулю записи запроса метаданных, который может записывать метаданные в файл растрового изображения. (Унаследовано от BitmapMetadata)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrySave()	Получает значение, указывающее, можно ли успешно сохранить метаданные изображения.
VerifyAccess()	Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Вызывает событие Changed для объекта Freezable и вызывает его метод OnChanged(). Классы, производные от Freezable, должны вызывать этот метод в конце любого API, который изменяет члены класса, не сохраненные в виде свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что объект Freezable не заморожен и доступ к нему осуществляется из допустимого контекста потока. Наследники объекта Freezable должны вызывать данный метод в начале любого API, который выполняет запись в элементах данных, не являющихся свойствами зависимостей. (Унаследовано от Freezable)

События

Changed

Происходит, когда изменяется класс Freezable или объект, который входит в его состав. (Унаследовано от Freezable)

Явные реализации интерфейса

IEnumerable.GetEnumerator()	Описание этого члена см. в разделе GetEnumerator(). (Унаследовано от BitmapMetadata)
IEnumerable<String>.GetEnumerator()	Описание этого члена см. в разделе GetEnumerator(). (Унаследовано от BitmapMetadata)

Методы расширения

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

• BitmapMetadata
• BitmapImage