IsNullConverter

IsNullConverter は、Object? を bool 値に変換する一方向のコンバーターです。

Convert メソッドは、バインドされたオブジェクトが null の場合は true を、その他の場合は false を返します。

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

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>

IsNullConverter の使用

IsNullConverter は、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.IsNullConverterPage">

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

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

</ContentPage>

C#

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

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

        label.SetBinding(
                Label.IsVisibleProperty,
                new Binding(nameof(ViewModels.MyObject), converter: new IsNullConverter()));

        Content = label;
    }
}

C# Markup

この CommunityToolkit.Maui.Markup パッケージを使うと、より簡潔な方法でこのコンバーターを C# で使用できます。

using CommunityToolkit.Maui.Markup;

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

例

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

API

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