IsStringNotNullOrEmptyConverter

IsStringNotNullOrEmptyConverter は、バインディング値が null でないか、string.Empty でないかどうかを示す bool を返す一方向のコンバーターです。

Convert メソッドは、バインドした value が null ではなく string.Empty でもない場合に true を返します。

この ConvertBack メソッドはサポートされていません。 逆のビヘイビアーについては、IsStringNullOrEmptyConverter を参照してください。

BaseConverter のプロパティ

基底クラス public abstract class BaseConverter には、以下のプロパティが実装されています。

ICommunityToolkitValueConverter プロパティ

public interface ICommunityToolkitValueConverter には以下のプロパティが実装されています。

構文

XAML

XAML 名前空間を含める

XAML でこのツールキットを使用するには、次の xmlns をページまたはビューに追加する必要があります。

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

したがって、以下のコードは、

<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>

次のように、xmlns を含むように変更されます。

<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>

IsStringNotNullOrEmptyConverter を使用する

IsStringNotNullOrEmptyConverter は、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.IsStringNotNullOrEmptyConverterPage">

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

    <Label Text="A value has been entered"
           IsVisible="{Binding MyValue, Converter={StaticResource IsStringNotNullOrEmptyConverter}}" />

</ContentPage>

C#

IsStringNotNullOrEmptyConverter は、C# では次のように使用できます。

class IsStringNotNullOrEmptyConverterPage : ContentPage
{
    public IsStringNotNullOrEmptyConverterPage()
    {
        var label = new Label { Text = "A value has been entered" };

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

        Content = label;
    }
}

C# Markup

この CommunityToolkit.Maui.Markup パッケージは、C# でこのコンバーターを使用するためのより簡潔な方法を提供します。

using CommunityToolkit.Maui.Markup;

class IsStringNotNullOrEmptyConverterPage : ContentPage
{
    public IsStringNotNullOrEmptyConverterPage()
    {
        Content = new Label { Text = "A value has been entered" }
            .Bind(
                Label.IsVisibleProperty,
                static (ViewModel vm) => vm.MyValue,
                converter: new IsStringNotNullOrEmptyConverter());
    }
}

例

このコンバーターの動作の例は「.NET MAUI Community Toolkit サンプル アプリケーション」で確認できます。

API

IsStringNotNullOrEmptyConverter のソース コードは、.NET MAUI Community Toolkit の GitHub リポジトリにあります。