Pack URIs in WPF

Descripción general

Apunte sobre cómo establecer una imagen incrustada en un recuso en WPF original

[TOC] Tabla de Contenidos

• Introducción
• Descripción del formato
• Ejemplos.

↑↑↑

Introducción

Este apunte muestra cómo usar el formato de direcciones [Pack Uri] en documentos Wpf tanto en código como en Xaml.

Ejemplo de código VB.Net

Dim finalImage As New Image()
finalImage.Width = 80
'...
Dim bi As New BitmapImage()
bi.BeginInit()
bi.UriSource = New Uri("pack://application:,,,/AssemblyName;component/Resources/logo.png")
bi.EndInit()
'...
finalImage.Source = bi

↑↑↑

Descripción del formato

El URI se divide en partes:

• Autoridad: application:///
  • (Observación)Las tres barras diagonales tras application: tienen que ser reemplazados con comas:
• Ruta de acceso: El nombre de un archivo de recursos compilado en un ensamblado al que se hacve referencia. La ruta de acceso debe ajustarse al siguiente formato: AssemblyShortName[;Version][;PublicKey];component/Path
  • AssemblyShortName: [opcional] (nombreCortoDeEnsamblado) Nombre corto del ensamblado al que se hace referencia.
  • ;Versión [opcional]: la versión del ensamblado al que se hace referencia y que contiene el archivo de recursos. Se utiliza cuando hay cargados dos o más ensamblados a los que se hace referencia con el mimso nombre corto.
  • ;Clavepublica [opcional]: la clave pública que se utiliza para firmar el ensamblado al que se hace referencia. Se utiliza cuando hay cargados dos o más ensamblados a los que se hace referencia con el mimso nombre corto.
  • ;componente [opcional]: especifica que la referencia al ensamblado se hace desde el ensamblado local..
  • /Ruta de acceso: nombre del archivo de recursos, incluida su ruta de acceso relativa a la carpeta raíz del proyecto del ensamblado al que se hace referencia.
• Notas:
  • El componente de autoridad de un pack URI es un URI incrustado que apunta a un paquete y debe ajustarse a RFC 2396. Además, el carácter "/" debe sustituirse por el carácter "," y los caracteres reservados tales como "%" y "?" deben incluirse en secuencias de escape. Vea la especificación de OPC para obtener información detallada.
  • Y, por supuesto, asegúrese de que cambiar la acción de compilación en la imagen al valor [Resource.]

↑↑↑

Ejemplos.

Ejemplo de código vb.Net

Dim finalImage As New Image()

(Ejemplo:La imagen esta en el mismo ensamblado que la usa)
Dim packUri As String = "pack://application:,,,/Imagenes/icon.png"

(Ejemplo:La imagen esta en otro ensamblado de la soucion)
Dim packUri As String = "pack://application:,,,/WpfControlLibrary2016;component/Imagenes/MenuPrint/PrintPreviewControl_698_32.bmp"

finalImage.Source = CType(New ImageSourceConverter().ConvertFromString(packUri), ImageSource)

Ejemplo en código Xaml

<image x:name="imageUno" source="pack://application:,,,/05.jpg" stretch="Uniform" />

<image x:name="imageDos" source="pack://application:,,,/imagenes/05.jpg" stretch="Uniform" />

A modo de recordatorio

• El caracter escape (el caracter por ciento) para un espacio en blanco es %20
• Wikipedia - Código porciento

↑↑↑

A.2.Enlaces

[Para saber mas]

URIs de paquete en Windows Presentation Foundation
Wikipedia - Percent-encoding
Wikipedia - Código porciento

[Grupo de documentos]

[Documento Index]

[Documento Start]

[Imprimir el Documento]