BitmapMetadata.GetQuery(String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Media.Imaging
Assembly:
PresentationCore.dll

Consente l'accesso a un lettore di query di metadati che consente di estrarre i metadati da un file di immagine bitmap.

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

Parametri

query
String

Identifica la stringa oggetto della query nell'oggetto BitmapMetadata corrente.

Restituisce

Object

Metadati nella posizione di query specificata.

Attributi
SecurityCriticalAttribute

Eccezioni

ArgumentNullException

query è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il SetQuery metodo per scrivere metadati in un file PNG (Portable Network Graphics).

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

Dopo la scrittura dei metadati, il GetQuery metodo viene usato per leggere tali dati e generarlo come stringa di testo.


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

Commenti

I metadati associati a un'immagine sono dati che descrivono l'immagine, ma che non è necessaria per la visualizzazione dell'immagine. Ogni formato di immagine bitmap supportato gestisce i metadati in modo diverso, ma la funzionalità per la lettura e la scrittura dei metadati è la stessa.

Windows Presentation Foundation (WPF) supporta gli schemi di metadati dell'immagine seguenti: file di immagine (Exif), tEXt (dati testuali PNG), directory di file di immagine (IFD), International Press Tetelecomunicazion Council (IPTC) e Extensible Metadata Platform (XMP).

Si applica a

Vedi anche