TextCaseConverter

El TextCaseConverter es un convertidor unidireccional que permite a los usuarios convertir el uso de mayúsculas y minúsculas de un enlace de tipo string entrante. La propiedad Type se usa para definir qué tipo de mayúsculas y minúsculas se aplicarán a la cadena.

El método Convert devuelve el value proporcionado convertido al TextCaseTypedefinido. Tenga en cuenta que el TextCaseType se puede proporcionar de las maneras siguientes:

1. como ConverterParameter en el enlace del convertidor,
2. como propiedad Type en el convertidor.

Tenga en cuenta que la opción ConverterParameter tendrá prioridad sobre la propiedad Type.

El método ConvertBack no se admite.

Propiedades de BaseConverter

Las siguientes propiedades se implementan en la clase base, public abstract class BaseConverter:

Propiedades de ICommunityToolkitValueConverter

Las siguientes propiedades se implementan en public interface ICommunityToolkitValueConverter:

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 TextCaseConverter

El TextCaseConverter 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.TextCaseConverterPage">

    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:TextCaseConverter x:Key="TextCaseConverter" Type="Upper" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <Label Text="{Binding MyValue, Converter={StaticResource TextCaseConverter}}" />

</ContentPage>

C#

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

class TextCaseConverterPage : ContentPage
{
    public TextCaseConverterPage()
    {
        var label = new Label();

        label.SetBinding(
            Label.TextProperty,
            new Binding(
                static (ViewModels vm) => vm.MyValue,
                converter: new TextCaseConverter { Type = TextCaseType.Upper }));

        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 TextCaseConverterPage : ContentPage
{
    public TextCaseConverterPage()
    {
        Content = new Label()
            .Bind(
                Label.TextProperty,
                static (ViewModel vm) => vm.MyValue,
                converter: new TextCaseConverter { Type = TextCaseType.Upper });
    }
}

Propiedades

TextCaseType

La enumeración TextCaseType define los miembros siguientes:

• None - No se aplica ningún formato específico a la cadena.
• Upper - Aplica formato mayúscula a la cadena.
• Lower - Aplica formato en minúsculas a la cadena.
• FirstUpperRestLower - Aplica formato mayúscula al primer carácter y, a continuación, formato en minúsculas a la cadena restante.

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