Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
ByteArrayToImageSourceConverter to konwerter, który umożliwia użytkownikowi konwersję wartości wejściowej z tablicy byte i zwraca ImageSource. Ten obiekt może następnie być używany jako Source kontrolki Image.
Metoda Convert zwraca podaną byte[]value wartość przekonwertowaną na element ImageSource.
Metoda ConvertBack zwraca podaną wartość ImageSourcevalue, przekonwertowaną na byte[].
Właściwości obiektu BaseConverter
Następujące właściwości są implementowane w klasie bazowej: public abstract class BaseConverter
| Właściwości | opis |
|---|---|
DefaultConvertReturnValue |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest stosowana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true. |
DefaultConvertBackReturnValue |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest stosowana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true. |
Właściwości ICommunityToolkitValueConverter
Następujące właściwości są implementowane w pliku public interface ICommunityToolkitValueConverter:
| Właściwości | Typ | opis |
|---|---|---|
DefaultConvertReturnValue |
object? |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.Convert(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest stosowana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true. |
DefaultConvertBackReturnValue |
object? |
Wartość domyślna, która ma być zwracana, gdy IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?) zgłasza wartość Exception. Ta wartość jest stosowana, gdy CommunityToolkit.Maui.Options.ShouldSuppressExceptionsInConverters jest ustawione na true. |
Składnia
XAML
Dołączanie przestrzeni nazw XAML
Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:
xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
Dlatego następujące:
<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>
Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:
<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>
Korzystanie z ByteArrayToImageSourceConverter
Elementu ByteArrayToImageSourceConverter można użyć w języku XAML w następujący sposób:
<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#
Elementu ByteArrayToImageSourceConverter można użyć w następujący sposób w 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;
}
}
Znaczniki języka C#
Nasz CommunityToolkit.Maui.Markup pakiet zapewnia znacznie bardziej zwięzły sposób używania tego konwertera w języku C#.
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());
}
}
Przykłady
Przykład działania tego konwertera można zobaczyć w przykładowej aplikacji .NET MAUI Community Toolkit.
API
Kod źródłowy ByteArrayToImageSourceConverter można znaleźć w repozytorium GitHub platformy .NET MAUI Community Toolkit.
.NET MAUI Community Toolkit