ImageResourceConverter

Artículo
03/14/2024

ImageResourceConverter es un convertidor que convierte el identificador de recurso de imagen incrustado en su ImageSource. Un recurso de imagen incrustado es cuando se ha agregado una imagen a un proyecto con la Acción de compilación establecida en recurso incrustado. Es id. es el nombre completo; por lo tanto, el espacio de nombres del proyecto + el nombre del recurso. En el ejemplo de un proyecto denominado CommunityToolkit.Maui.Sample, un conjunto de carpetas anidadas de Resources/Embedded y una imagen denominada dotnetbot.png el identificador se generaría con:

CommunityToolkit.Maui.Sample + Resources.Embedded + dotnetbot.png

que da como resultado:

CommunityToolkit.Maui.Sample.Resources.Embedded.dotnetbot.png

Propiedades de BaseConverter

Las siguientes propiedades se implementan en la clase base, public abstract class BaseConverter:

Propiedad	Descripción
`DefaultConvertReturnValue`	Valor predeterminado que se devuelve cuando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.
`DefaultConvertBackReturnValue`	Valor predeterminado que se devuelve cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.

Propiedades de ICommunityToolkitValueConverter

Las siguientes propiedades se implementan en public interface ICommunityToolkitValueConverter:

Propiedad	Tipo	Descripción
`DefaultConvertReturnValue`	`object?`	Valor predeterminado que se devuelve cuando `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.
`DefaultConvertBackReturnValue`	`object?`	Valor predeterminado que se devuelve cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produce una `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` se establece en `true`.

Sintaxis

XAML

Incluir el espacio de nombres XAML

Para usar el kit de herramientas en XAML, es necesario agregar el siguiente xmlns a la página o vista:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Por lo tanto, el siguiente:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Se modificaría para incluir el xmlns de la siguiente manera:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Uso de ImageResourceConverter

El ImageResourceConverter se puede usar de la siguiente manera en XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.ImageResourceConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:ImageResourceConverter x:Key="ImageResourceConverter" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <Image Source="{Binding MyImageResource, Converter={StaticResource ImageResourceConverter}}" />

</ContentPage>

C#

El ImageResourceConverter se puede usar de la siguiente manera en C#:

class ImageResourceConverterPage : ContentPage
{
    public ImageResourceConverterPage()
    {
        var image = new Image();

        image.SetBinding(
            Image.SourceProperty, 
            new Binding(
                static (ViewModel vm) => vm.MyImageResource, 
                converter: new ImageResourceConverter())); 

        Content = label;        
    }
}

Marcado de C#

Nuestro paquete CommunityToolkit.Maui.Markup proporciona una forma mucho más concisa de usar este convertidor en C#.

using CommunityToolkit.Maui.Markup;

class ImageResourceConverterPage : ContentPage
{
    public ImageResourceConverterPage()
    {
        Content = new Image()
            .Bind(
                Label.SourceProperty, 
                static (ViewModel vm) => vm.MyImageResource,
                converter: new ImageResourceConverter()); 
    }
}

Ejemplos

Puede encontrar un ejemplo de este convertidor en acción en la Aplicación de muestra del kit de herramientas de la comunidad de .NET MAUI.

API

Puede encontrar el código fuente de ImageResourceConverter en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.

Compartir a través de