BitmapMetadata.GetQuery(String) Methode

Referenz

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet Zugriff auf eine Metadatenabfrage-Readers, der Metadaten aus einer Bitmap-Bilddatei extrahieren kann.

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

[System.Security.SecurityCritical]
public object GetQuery (string query);

public object GetQuery (string query);

[<System.Security.SecurityCritical>]
member this.GetQuery : string -> obj

member this.GetQuery : string -> obj

Public Function GetQuery (query As String) As Object

Parameter

query: String

Identifiziert die Zeichenfolge, die im aktuellen BitmapMetadata-Objekt abgefragt wird.

Gibt zurück

Object

Die Metadaten an der angegebenen Abfrageposition.

Attribute: SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

query ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die SetQuery -Methode zum Schreiben von Metadaten in eine PNG-Datei (Portable Network Graphics) verwendet wird.

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

Nachdem die Metadaten geschrieben wurden, wird die GetQuery -Methode verwendet, um diese Daten zu lesen und als Textzeichenfolge ausgibt.


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

Hinweise

Metadaten, die einem Bild zugeordnet sind, sind Daten, die das Bild beschreiben, aber für die Anzeige des Bilds nicht erforderlich sind. Jedes unterstützte Bitmapbildformat behandelt Metadaten unterschiedlich, aber die Möglichkeit zum Lesen und Schreiben von Metadaten ist identisch.

Windows Presentation Foundation (WPF) unterstützt die folgenden Bildmetadatenschemas: Austauschbare Bilddatei (Exif), tEXt (PNG Textual Data), Bilddateiverzeichnis (IFD), International Press Telecommunications Council (IPTC) und Extensible Metadata Platform (XMP).

Gilt für:

Freigeben über