ByteArrayToImageSource Converter

De ByteArrayToImageSourceConverter is een converter waarmee de gebruiker een binnenkomende waarde uit een byte array kan omzetten en die een ImageSource retourneert. Dit object kan vervolgens worden gebruikt als de Source van een Image-besturingselement.

De methode Convert retourneert de opgegeven byte[]value, geconverteerd naar een ImageSource.

De methode ConvertBack retourneert de meegeleverde ImageSourcevalue, geconverteerd naar een byte[].

Eigenschappen van BaseConverter

De volgende eigenschappen worden geïmplementeerd in de basisklasse: public abstract class BaseConverter

Property Description
DefaultConvertReturnValue Standaardwaarde die wordt geretourneerd wanneer IValueConverter.Convert(object?, Type, object?, CultureInfo?) een Exception genereert. Deze waarde wordt gebruikt wanneer CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters is ingesteld op true.
DefaultConvertBackReturnValue Standaardwaarde die moet worden geretourneerd wanneer IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) een Exception genereert. Deze waarde wordt gebruikt wanneer CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters is ingesteld op true.

Eigenschappen van ICommunityToolkitValueConverter

De volgende eigenschappen worden geïmplementeerd in:public interface ICommunityToolkitValueConverter

Property Type Description
DefaultConvertReturnValue object? Standaardwaarde die moet worden teruggegeven wanneer IValueConverter.Convert(object?, Type, object?, CultureInfo?) een Exception genereert. Deze waarde wordt gebruikt wanneer CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters is ingesteld op true.
DefaultConvertBackReturnValue object? Standaardwaarde die wordt geretourneerd wanneer IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) een Exception genereert. Deze waarde wordt gebruikt wanneer CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters is ingesteld op true.

Syntax

XAML

Inclusief de XAML-naamruimte

Als u de toolkit in XAML wilt gebruiken, moet de volgende xmlns worden toegevoegd aan uw pagina of weergave:

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

Daarom volgt het volgende:

<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>

Zou als volgt worden gewijzigd om de xmlns op te nemen:

<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>

De ByteArrayToImageSourceConverter gebruiken

De ByteArrayToImageSourceConverter kan als volgt worden gebruikt in 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.ByteArrayToImageSourceConverterPage">

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

    <Image Source="{Binding DotNetBotImageByteArray, Mode=OneWay, Converter={StaticResource ByteArrayToImageSourceConverter}}" />

</ContentPage>

C#

De ByteArrayToImageSourceConverter kan als volgt worden gebruikt in C#:

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

    image.SetBinding(
        Image.SourceProperty,
        new Binding(
            static (ViewModel vm) => vm.DotNetBotImageByteArray,
            mode: BindingMode.OneWay,
            converter: new ByteArrayToImageSourceConverter()));

        Content = image;
    }
}

C#-markeringen

Ons CommunityToolkit.Maui.Markup pakket biedt een veel beknoptere manier om dit conversieprogramma in C# te gebruiken.

using CommunityToolkit.Maui.Markup;

class ByteArrayToImageSourceConverterPage : ContentPage
{
    public ByteArrayToImageSourceConverterPage()
    {
        Content = new Image()
            .Bind(
                Image.SourceProperty,
                static (ViewModel vm) => vm.DotNetBotImageByteArray,
                mode: BindingMode.OneWay,
                converter: new ByteArrayToImageSourceConverter());
    }
}

Examples

U vindt een voorbeeld van dit conversieprogramma in actie in de .NET MAUI Community Toolkit Sample Application.

API

U vindt de broncode voor ByteArrayToImageSourceConverter in de .NET MAUI Community Toolkit GitHub opslagplaats.