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.

WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF) 다음 이미지 메타 데이터 스키마 지원: EXIF(교환 이미지 파일 형식)Exchangeable image file (Exif), 텍스트 (PNGPNG 텍스트 데이터), IFD(이미지 파일 디렉터리)image file directory (IFD)IPTC(International Press Telecommunications Council)International Press Telecommunications Council (IPTC), 및 XMP(Extensible Metadata Platform)Extensible Metadata Platform (XMP)합니다.supports the following image metadata schemas: EXIF(교환 이미지 파일 형식)Exchangeable image file (Exif), tEXt (PNGPNG Textual Data), IFD(이미지 파일 디렉터리)image file directory (IFD), IPTC(International Press Telecommunications Council)International Press Telecommunications Council (IPTC), and XMP(Extensible Metadata Platform)Extensible Metadata Platform (XMP).

적용 대상

추가 정보