BitmapMetadata.GetQuery(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit l’accès à un lecteur de requête 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 -> objmember this.GetQuery : string -> objPublic Function GetQuery (query As String) As ObjectParamètres
- query
- String
Identifie la chaîne interrogée dans l’objet actuel BitmapMetadata .
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())
{
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())
{ 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 l’é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 n’est pas nécessaire 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 de 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 exchangeable (Exif), tEXt (PNG Textual Data), répertoire de fichiers image (IFD), International Press Telecommunications Council (IPTC) et Extensible Metadata Platform (XMP).
