BitmapMetadata.SetQuery(String, Object) BitmapMetadata.SetQuery(String, Object) BitmapMetadata.SetQuery(String, Object) BitmapMetadata.SetQuery(String, Object) Method

定義

ビットマップ イメージ ファイルにメタデータを書き込めるメタデータ クエリ ライターへのアクセスを提供します。Provides access to a metadata query writer that can write metadata to a bitmap image file.

public:
 void SetQuery(System::String ^ query, System::Object ^ value);
[System.Security.SecurityCritical]
public void SetQuery (string query, object value);
member this.SetQuery : string * obj -> unit
Public Sub SetQuery (query As String, value As Object)

パラメーター

query
String String String String

書き込むメタデータの場所を識別します。Identifies the location of the metadata to be written.

value
Object Object Object Object

書き込むメタデータの値。The value of the metadata to be written.

次のコード例は、 SetQueryメソッドを使用してメタデータをポータブル ネットワーク グラフィックス (PNG)Portable Network Graphics (PNG)ファイルに書き込む方法を示しています。The following code example demonstrates how to use the SetQuery method to write metadata to a ポータブル ネットワーク グラフィックス (PNG)Portable Network Graphics (PNG) file.

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 、メソッドを使用してそのデータが読み取られ、テキスト文字列として出力されます。After the metadata is written, the GetQuery method is used to read that data and emit it as a text string.


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

注釈

イメージに関連付けられているメタデータは、イメージを記述するデータですが、イメージの表示には必要ありません。Metadata that is associated with an image is data that describes the image but that is not necessary for display of the image. サポートされているビットマップイメージ形式では、メタデータの処理方法が異なりますが、メタデータの読み取りと書き込みの機能は同じです。Each supported bitmap image format handles metadata differently, but the facility for reading and writing metadata is the same.

Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)Exchangeable Image File (Exif)Exchangeable image file (Exif)では、テキスト (PNGPNGテキストデータ) イメージ ファイル ディレクトリ (IFD)image file directory (IFD) 国際新聞通信委員会 (IPTC)International Press Telecommunications Council (IPTC)、、、および拡張可能メタデータ プラットフォーム (XMP)Extensible Metadata Platform (XMP)のイメージメタデータスキーマがサポートされています。supports the following image metadata schemas: Exchangeable Image File (Exif)Exchangeable image file (Exif), tEXt (PNGPNG Textual Data), イメージ ファイル ディレクトリ (IFD)image file directory (IFD), 国際新聞通信委員会 (IPTC)International Press Telecommunications Council (IPTC), and 拡張可能メタデータ プラットフォーム (XMP)Extensible Metadata Platform (XMP).

適用対象

こちらもご覧ください