IsStringNullOrWhiteSpaceConverter

Artículo
03/16/2024

IsStringNullOrWhiteSpaceConverter es un convertidor unidireccional que devuelve un bool que indica si el valor de enlace es null, string.Empty o contiene solo caracteres de espacio en blanco.

El método Convert devuelve true cuando el value de enlace es null, string.Empty o solo contiene caracteres de espacio en blanco.

El método ConvertBack no se admite. Para ver el comportamiento opuesto, consulte IsStringNotNullOrWhiteSpaceConverter.

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 `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` está establecido en `true`.
`DefaultConvertBackReturnValue`	Valor predeterminado que se devolverá cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produzca `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 `Exception`. Este valor se usa cuando CommunityToolkit.Maui.Options`.ShouldSuppressExceptionsInConverters` está establecido en `true`.
`DefaultConvertBackReturnValue`	`object?`	Valor predeterminado que se devolverá cuando `IValueConverter.ConvertBack(object?, Type, object?, CultureInfo?)` produzca `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 IsStringNullOrWhitespaceConverter

El IsStringNullOrWhiteSpaceConverter 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.IsStringNullOrWhiteSpaceConverterPage">

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

    <Label Text="A value is required"
           IsVisible="{Binding MyValue, Converter={StaticResource IsStringNullOrWhiteSpaceConverter}}" />

</ContentPage>

C#

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

class IsStringNullOrWhiteSpaceConverterPage : ContentPage
{
    public IsStringNullOrWhiteSpaceConverterPage()
    {
        var label = new Label { Text = "A value is required" };

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

        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 IsStringNullOrWhiteSpaceConverterPage : ContentPage
{
    public IsStringNullOrWhiteSpaceConverterPage()
    {
        Content = new Label { Text = "A value is required" }
            .Bind(
                Label.IsVisibleProperty,
                static (ViewModel vm) => vm.MyValue,
                converter: new IsStringNullOrWhiteSpaceConverter());
    }
}

Ejemplos

Encontrará un ejemplo de este convertidor en acción en la Aplicación de ejemplo del kit de herramientas de la comunidad de .NET MAUI.

API

Puede encontrar el código fuente de IsStringNullOrWhiteSpaceConverter en el repositorio de GitHub del Kit de herramientas de la comunidad de .NET MAUI.

Compartir a través de