BitmapMetadata.GetQuery(String) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Media.Imaging

Ensamblado:: PresentationCore.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona acceso a un lector de consultas de metadatos que puede extraer metadatos de un archivo de imagen de mapa de bits.

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

query: String

Identifica la cadena que se está consultando en el objeto BitmapMetadata actual.

Devoluciones

Object

Metadatos en la ubicación de consulta especificada.

Atributos: SecurityCriticalAttribute

Excepciones

ArgumentNullException

query es null.

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

Compartir vía