BitmapMetadata.GetQuery(String) メソッド

定義

名前空間:

System.Windows.Media.Imaging

アセンブリ:

PresentationCore.dll

ビットマップ イメージ ファイルからメタデータを抽出できるメタデータ クエリ リーダーにアクセスを提供します。

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

public object GetQuery (string query);

member this.GetQuery : string -> obj

Public Function GetQuery (query As String) As Object

パラメーター

query

String

現在の BitmapMetadata オブジェクトでクエリが実行される文字列を識別します。

戻り値

Object

指定したクエリの場所にあるメタデータ。

例外

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())
{
   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())
{ 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) では、Exchangeable image file (Exif)、tEXt (PNG Textual Data)、image file directory (IFD)、International Press Telecommunications Council (IPTC)、Extensible Metadata Platform (XMP) の画像メタデータ スキーマがサポートされています。

こちらもご覧ください

• ポータブル ネットワーク グラフィックス テキスト データ (tEXt) の仕様
• 国際報道通信協議会 (IPTC) スキーマ情報
• Adobe Extensible Metadata Platform (XMP)
• EXIF (交換可能なイメージ ファイル形式) の仕様