ListToStringConverter
ListToStringConverter
es un convertidor unidireccional que devuelve una concatenación de los miembros de una colección, utilizando el separador especificado entre cada miembro.
El método Convert
devuelve una concatenación de los miembros de una colección utilizando el separador especificado entre cada miembro.
Nota:
Tenga en cuenta que los separadores se pueden proporcionar de las maneras siguientes:
- Como
ConverterParameter
en el enlace del convertidor - Como la propiedad
Separator
en el convertidor
Tenga en cuenta que la opción ConverterParameter
tendrá prioridad sobre la propiedad Separator
.
No se admite el método ConvertBack
. Para ver el comportamiento opuesto, vea StringToListConverter
.
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>
Usar ListToStringConverter
El ListToStringConverter
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.ListToStringConverterPage">
<ContentPage.Resources>
<ResourceDictionary>
<toolkit:ListToStringConverter x:Key="ListToStringConverter" Separator="," />
</ResourceDictionary>
</ContentPage.Resources>
<Label Text="{Binding MyListValue, Converter={StaticResource ListToStringConverter}}" />
</ContentPage>
C#
El ListToStringConverter
se puede usar de la siguiente manera en C#:
class ListToStringConverterPage : ContentPage
{
public ListToStringConverterPage()
{
var label = new Label();
label.SetBinding(
Label.TextProperty,
new Binding(
static (ViewModels vm) => vm.MyListValue,
converter: new ListToStringConverter() { Separator = "," }));
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 ListToStringConverterPage : ContentPage
{
public ListToStringConverterPage()
{
Content = new Label()
.Bind(
Label.TextProperty,
static (ViewModel vm) => vm.MyListValue,
converter: new ListToStringConverter(),
converterParameter: ",");
}
}
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
Separador | string |
Valor que separa cada elemento de la colección. Este valor se sustituye por ConverterParameter, si se proporciona. Si ConverterParameter es null, se usará esta propiedad Separador. |
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 ListToStringConverter
en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.
.NET MAUI Community Toolkit