BitmapMetadata.SetQuery(String, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media.Imaging

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia dostęp do modułu zapisywania zapytań metadanych, który może zapisywać metadane w pliku obrazu mapy bitowej.

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 -> unit

member this.SetQuery : string * obj -> unit

Public Sub SetQuery (query As String, value As Object)

Parametry

query: String

Określa lokalizację metadanych do zapisania.

value: Object

Wartość metadanych do zapisania.

Atrybuty: SecurityCriticalAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak używać SetQuery metody do zapisywania metadanych w pliku Portable Network Graphics (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()

Po zapisaniu GetQuery metadanych metoda służy do odczytywania tych danych i emitowania ich jako ciągu tekstowego.


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

Uwagi

Metadane skojarzone z obrazem to dane opisujące obraz, ale nie są niezbędne do wyświetlania obrazu. Każdy obsługiwany format obrazu mapy bitowej obsługuje metadane inaczej, ale obiekt do odczytywania i zapisywania metadanych jest taki sam.

Windows Presentation Foundation (WPF) obsługuje następujące schematy metadanych obrazów: plik obrazu z możliwością wymiany (Exif), tEXt (PNG Textual Data), katalog plików obrazów (IFD), International Press Telecommunications Council (IPTC) i rozszerzalna platforma metadanych (XMP).

Dotyczy