BitmapMetadata.SetQuery(String, Object) Méthode

Référence

Définition

Espace de noms:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

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.

Donne accès à un générateur de requêtes de métadonnées qui peut écrire des métadonnées dans un fichier image bitmap.

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)

Paramètres

query: String

Identifie l’emplacement des métadonnées à écrire.

value: Object

Valeur des métadonnées à écrire.

Attributs: SecurityCriticalAttribute

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 l’émettre en tant que 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 facilité 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).

S’applique à

Partager via