BitmapMetadata.GetQuery(String) BitmapMetadata.GetQuery(String) BitmapMetadata.GetQuery(String) BitmapMetadata.GetQuery(String) Method

정의

비트맵 이미지 파일에서 메타데이터를 추출할 수 있는 메타데이터 쿼리 판독기에 대한 액세스를 제공합니다.Provides access to a metadata query reader that can extract metadata from a bitmap image file.

public:
 System::Object ^ GetQuery(System::String ^ query);
[System.Security.SecurityCritical]
public object GetQuery (string query);
member this.GetQuery : string -> obj
Public Function GetQuery (query As String) As Object

매개 변수

query
String String String String

현재 BitmapMetadata 개체에서 쿼리되는 문자열을 식별합니다.Identifies the string that is being queried in the current BitmapMetadata object.

반환

지정된 쿼리 위치에 있는 메타데이터입니다.The metadata at the specified query location.

예외

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 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).

적용 대상

추가 정보