StringToListConverter

Článek
11/11/2023

Jedná se StringToListConverter o jednosměrný převaděč, který vrací sadu podřetězců rozdělením vstupního řetězce na základě jednoho nebo více oddělovačů.

Metoda Convert vrátí sadu podřetězců rozdělením vstupního řetězce na základě jednoho nebo více oddělovačů.

Poznámka:

Všimněte si, že oddělovače lze zadat v následujícím pořadí priorit:

ConverterParameter jako v vazbě převaděče; nahrazuje obě Separators vlastnosti i Separator vlastnosti.
Separators jako vlastnost převaděče; tato vlastnost nahrazuje Separator vlastnost
Separator jako vlastnost v převaděči.

Metoda ConvertBack není podporována. Pro opačné chování viz .ListToStringConverter

BaseConverter – vlastnosti

V základní třídě jsou implementovány následující vlastnosti: public abstract class BaseConverter

Vlastnost	Popis
`DefaultConvertReturnValue`	Výchozí hodnota, která se má vrátit při `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .
`DefaultConvertBackReturnValue`	Výchozí hodnota, která se má vrátit při `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .

ICommunityToolkitValueConverter – vlastnosti

Následující vlastnosti jsou implementovány v public interface ICommunityToolkitValueConverter:

Vlastnost	Type	Popis
`DefaultConvertReturnValue`	`object?`	Výchozí hodnota, která se má vrátit při `IValueConverter.Convert(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .
`DefaultConvertBackReturnValue`	`object?`	Výchozí hodnota, která se má vrátit při `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` vyvolání .`Exception` Tato hodnota se používá, když Je nastavena možnost `true`CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` .

Syntaxe

XAML

Zahrnutí oboru názvů XAML

Pokud chcete použít sadu nástrojů v XAML, musíte do stránky nebo zobrazení přidat následující xmlns položky:

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

Proto platí následující:

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

Bylo by změněno tak, aby zahrnovalo xmlns následující:

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

Použití StringToListConverter

V XAML je možné ho StringToListConverter použít následujícím způsobem:

<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.StringToListConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
             <toolkit:StringToListConverter x:Key="StringToListConverter" SplitOptions="RemoveEmptyEntries">
                <toolkit:StringToListConverter.Separators>
                    <x:String>,</x:String>
                    <x:String>.</x:String>
                    <x:String>;</x:String>
                </toolkit:StringToListConverter.Separators>
            </toolkit:StringToListConverter>
        </ResourceDictionary>
    </ContentPage.Resources>

    <VerticalStackLayout>
        <Entry
            Placeholder="Enter some text separated by ',' or '.' or ';'"
            Text="{Binding MyValue}" />

        <CollectionView ItemsSource="{Binding MyValue, Converter={StaticResource StringToListConverter}}">
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <Label Text="{Binding .}" />
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </VerticalStackLayout>

</ContentPage>

C#

V StringToListConverter jazyce C# je možné ho použít následujícím způsobem:

class StringToListConverterPage : ContentPage
{
    public StringToListConverterPage()
    {
		var entry = new Entry { Placeholder = "Enter some text separated by ',' or '.' or ';'" };
		entry.SetBinding(Entry.TextProperty, new Binding(nameof(ViewModel.MyValue)));

		var stringToListConverter = new StringToListConverter
		{
			SplitOptions = System.StringSplitOptions.RemoveEmptyEntries,
			Separators = new [] { ",", ".", ";" }
		};

		var collectionView = new CollectionView
		{
			ItemTemplate = new DataTemplate(() =>
			{
				var itemLabel = new Label();
				itemLabel.SetBinding(Label.TextProperty, path: ".");
				return itemLabel;
			})
		};

		collectionView.SetBinding(
			CollectionView.ItemsSourceProperty,
			new Binding(
				nameof(ViewModel.MyValue),
				converter: stringToListConverter));

		Content = new VerticalStackLayout
        {
            Children =    
            {
                entry,
                collectionView
            }
        };
    }
}

Revize jazyka C#

Náš CommunityToolkit.Maui.Markup balíček nabízí mnohem stručnější způsob použití tohoto převaděče v jazyce C#.

using CommunityToolkit.Maui.Markup;

class StringToListConverterPage : ContentPage
{
    public StringToListConverterPage()
    {
        Content = new VerticalStackLayout
        {
            Children =    
            {
                new Entry { Placeholder = "Enter some text separated by ',' or '.' or ';'" }
                    .Bind(
                        Entry.TextProperty, 
                        static (ViewModel vm) => vm.MyValue),

                new CollectionView
                {
                    ItemTemplate = new DataTemplate(() => new Label().Bind(Label.TextProperty, path: Binding.SelfPath))
                }.Bind(
                    CollectionView.ItemsSourceProperty,
                    static (ViewModel vm) => vm.MyValue,
                    converter: new StringToListConverter
                    {
                        SplitOptions = System.StringSplitOptions.RemoveEmptyEntries,
                        Separators = new [] { ",", ".", ";" }
                    })
            }
        };
    }
}

Vlastnosti

Vlastnost	Type	Popis
Oddělovač	`string`	Řetězec, který odděluje podřetězce v příchozím řetězci. Tato hodnota je nahrazena oběma `ConverterParameter` a `Separators`. Pokud `ConverterParameter` je a `Separators` je `null` prázdná, použije se tato hodnota.
Oddělovače	`IList<string>`	Řetězce, které odděluje podřetězce v příchozím řetězci. Tato hodnota je nahrazena `ConverterParameter`. Pokud `ConverterParameter` je `null` tato hodnota, použije se.
SplitOptions	`StringSplitOptions`	Bitové kombinace hodnot výčtu, která určuje, zda se mají oříznout podřetězce a zahrnout prázdné podřetězce.

Příklady

Příklad tohoto převaděče najdete v akci v ukázkové aplikaci .NET MAUI Community Toolkit.

rozhraní API

Zdrojový kód StringToListConverter najdete v úložišti .NET MAUI Community Toolkit na GitHubu.

Sdílet prostřednictvím