BitmapMetadata.SetQuery(String, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビットマップ イメージ ファイルにメタデータを書き込めるメタデータ クエリ ライターへのアクセスを提供します。
public:
void SetQuery(System::String ^ query, System::Object ^ value);[System.Security.SecurityCritical]
public void SetQuery (string query, object value);public void SetQuery (string query, object value);[<System.Security.SecurityCritical>]
member this.SetQuery : string * obj -> unitmember this.SetQuery : string * obj -> unitPublic Sub SetQuery (query As String, value As Object)パラメーター
- query
- String
書き込むメタデータの場所を識別します。
- value
- Object
書き込むメタデータの値。
- 属性
例
次のコード例は、このメソッドを使用 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) では、Exchangeable Image File (Exif)、tEXt (PNG Textual Data)、イメージ ファイル ディレクトリ (IFD)、International Press Telecommunications Council (IPTC)、および拡張メタデータ プラットフォーム (XMP) というイメージ メタデータ スキーマがサポートされています。