IsNotNullConverter

El IsNotNullConverter es un convertidor unidireccional que convierte Object? en un valor bool.

El Convertmétodo devuelve false cuando el objeto enlazado se null o true de lo contrario.

No se admite el método ConvertBack. Para ver el comportamiento opuesto, vea IsNullConverter.

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 IsNotNullConverter

El IsNotNullConverter 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.IsNotNullConverterPage">

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

    <Label Text="Object is not null"
           IsVisible="{Binding MyObject, Converter={StaticResource IsNotNullConverter}}" />

</ContentPage>

C#

El IsNotNullConverter se puede usar de la siguiente manera en C#:

class IsNotNullConverterPage : ContentPage
{
    public IsNotNullConverterPage()
    {
        var label = new Label { Text = "Object is not null" };

        label.SetBinding(
            Label.IsVisibleProperty,
            new Binding(static (ViewModels vm) => vm.MyObject, converter: new IsNotNullConverter()));

        Content = label;
    }
}

Marcado de C#

NuestroCommunityToolkit.Maui.Markup paquete proporciona una forma mucho más concisa de usar este convertidor en C#.

using CommunityToolkit.Maui.Markup;

class IsNotNullConverterPage : ContentPage
{
    public IsNotNullConverterPage()
    {
        Content = new Label { Text = "Object is not null" }
            .Bind(
                Label.IsVisibleProperty,
                static (ViewModel vm) => vm.MyObject,
                converter: new IsNotNullConverter());
    }
}

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 IsNotNullConverter en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.