Partager via


BitmapMetadata.GetQuery(String) Méthode

Définition

Donne accès à un lecteur de requêtes de métadonnées qui peut extraire des métadonnées à partir d’un fichier image 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

Paramètres

query
String

Identifie la chaîne interrogée dans l’objetBitmapMetadata actuel.

Retours

Métadonnées à l’emplacement de requête spécifié.

Attributs

Exceptions

query a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser la SetQuery méthode pour écrire des métadonnées dans un fichier 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()

Une fois les métadonnées écrites, la GetQuery méthode est utilisée pour lire ces données et les émettre sous forme de chaîne de texte.


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

Remarques

Les métadonnées associées à une image sont des données qui décrivent l’image, mais qui ne sont pas nécessaires pour l’affichage de l’image. Chaque format d’image bitmap pris en charge gère les métadonnées différemment, mais la fonctionnalité de lecture et d’écriture des métadonnées est la même.

Windows Presentation Foundation (WPF) prend en charge les schémas de métadonnées d’image suivants : fichier image échangeable (Exif), tEXt (PNG Textual Data), répertoire de fichiers image (IFD), International Press Telecommunications Council (IPTC) et Extensible Metadata Platform (XMP).

S’applique à

Voir aussi