BitmapMetadata.GetQuery(String) Método

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

Parámetros

Devoluciones

Metadatos en la ubicación de consulta especificada.

Atributos

SecurityCriticalAttribute

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el SetQuery método para escribir metadatos en un archivo 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()

Una vez escritos los metadatos, el GetQuery método se usa para leer esos datos y emitirlos como una cadena de texto.

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

Comentarios

Los metadatos asociados a una imagen son datos que describen la imagen, pero que no es necesario para mostrar la imagen. Cada formato de imagen de mapa de bits admitido controla los metadatos de forma diferente, pero la facilidad para leer y escribir metadatos es la misma.

Windows Presentation Foundation (WPF) admite los siguientes esquemas de metadatos de imagen: Archivo de imagen intercambiable (Exif), tEXt (datos textuales PNG), directorio de archivos de imagen (IFD), International Press Telecommunications Council (IPTC) y Extensible Metadata Platform (XMP).

Se aplica a

Consulte también

• Especificación de datos textuales de gráficos de red portátiles (tEXt)
• Información de esquema del Consejo Internacional de Telecomunicaciones de Prensa (IPTC)
• Plataforma de metadatos extensible de Adobe (XMP)
• Especificación exIF (formato de archivo de imagen intercambiable)