IsListNullOrEmptyConverter
El IsListNullOrEmptyConverter
es un convertidor unidireccional que convierte IEnumerable
en un valor bool
.
El método Convert
devuelve true
cuando null
o se pasa un IEnumerable
vacío o false
de lo contrario.
El método ConvertBack
no se admite. Para ver el comportamiento opuesto, consulte IsListNotNullOrEmptyConverter
.
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 está establecido 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 está establecido 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 está establecido 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 está establecido 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 IsListNullOrEmptyConverter
El IsListNullOrEmptyConverter
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.IsListNullOrEmptyConverterPage">
<ContentPage.Resources>
<ResourceDictionary>
<toolkit:IsListNullOrEmptyConverter x:Key="IsListNullOrEmptyConverter" />
</ResourceDictionary>
</ContentPage.Resources>
<Label Text="The list is empty"
IsVisible="{Binding MyList, Converter={StaticResource IsListNullOrEmptyConverter}}" />
</ContentPage>
C#
El IsListNullOrEmptyConverter
se puede usar de la siguiente manera en C#:
class IsListNullOrEmptyConverterPage : ContentPage
{
public IsListNullOrEmptyConverterPage()
{
var label = new Label { Text = "The list is not empty" };
label.SetBinding(
Label.IsVisibleProperty,
new Binding(static (ViewModels vm) => vm.MyList,
converter: new IsListNullOrEmptyConverter()));
Content = label;
}
}
Marcado de C#
Nuestro paquete de CommunityToolkit.Maui.Markup
proporciona una forma mucho más concisa de usar este convertidor en C#.
using CommunityToolkit.Maui.Markup;
class IsListNullOrEmptyConverterPage : ContentPage
{
public IsListNullOrEmptyConverterPage()
{
Content = new Label { Text = "The list is not empty" }
.Bind(
Label.IsVisibleProperty,
static (ViewModel vm) => vm.MyList,
converter: new IsListNullOrEmptyConverter());
}
}
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 IsListNullOrEmptyConverter
en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.
.NET MAUI Community Toolkit