BitmapMetadata.GetQuery(String) Метод

Ссылка

Определение

Пространство имен:: System.Windows.Media.Imaging

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public:
 System::Object ^ GetQuery(System::String ^ query);

[System.Security.SecurityCritical]
public object GetQuery (string query);

public object GetQuery (string query);

[<System.Security.SecurityCritical>]
member this.GetQuery : string -> obj

member this.GetQuery : string -> obj

Public Function GetQuery (query As String) As Object

Параметры

query: String

Определяет строку, запрашиваемую в текущем объекте BitmapMetadata.

Возвращаемое значение

Object

Метаданные в указанном расположении запроса.

Атрибуты: SecurityCriticalAttribute

Исключения

ArgumentNullException

query имеет значение null.

Примеры

В следующем примере кода показано, как использовать SetQuery метод для записи метаданных в PNG-файл.

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()

После записи GetQuery метаданных метод используется для чтения данных и их выдачи в виде текстовой строки.


// Add the metadata of the bitmap image to the text block.
TextBlock^ myTextBlock = gcnew TextBlock();
myTextBlock->Text = "The Description metadata of this image is: " + pngInplace->GetQuery("/Text/Description")->ToString();


// Add the metadata of the bitmap image to the text block.
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "The Description metadata of this image is: " + pngInplace.GetQuery("/Text/Description").ToString();

' Add the metadata of the bitmap image to the text block.
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "The Description metadata of this image is: " + pngInplace.GetQuery("/Text/Description").ToString()

Метаданные, связанные с изображением, — это данные, которые описывают изображение, но не являются обязательными для отображения изображения. Каждый поддерживаемый формат растрового изображения обрабатывает метаданные по-разному, но возможности для чтения и записи метаданных одинаковы.

Windows Presentation Foundation (WPF) поддерживает следующие схемы метаданных изображений: файл с обменом изображения (Exif), tEXt (текстовые данные PNG), каталог файлов изображений (IFD), Международный совет по телекоммуникациям для прессы (IPTC) и платформа расширяемых метаданных (XMP).

Применяется к

Поделиться через