x:Bind の関数

[アーティクル]
07/13/2023

注意

{x:Bind} によりアプリでデータバインディングを使う方法に関する一般的な情報 (および {x:Bind} と {Binding} の全体的な比較) については、「データバインディングの詳細」および「{x:Bind} マークアップ拡張」をご覧ください。

Windows 10 バージョン 1607 以降、{x:Bind} はバインドパスのリーフステップとしての関数の使用をサポートします。これにより、次のことを実現できます。

値の変換を実現するためのより簡単な方法
複数のパラメーターに依存するようにバインディングする方法

注意

{x:Bind} で関数を使うには、アプリの対象が SDK バージョン 14393 以降である必要があります。アプリがそれよりも前のバージョンの Windows 10 を対象としている場合は、関数を使用できません。ターゲットバージョンについて詳しくは、「バージョンアダプティブコード」をご覧ください。

次の例では、項目の背景と前景が、Color パラメーターに基づいて変換を行うために関数にバインドされています。

<DataTemplate x:DataType="local:ColorEntry">
    <Grid Background="{x:Bind local:ColorEntry.Brushify(Color), Mode=OneWay}" Width="240">
        <TextBlock Text="{x:Bind ColorName}" Foreground="{x:Bind TextColor(Color)}" Margin="10,5" />
    </Grid>
</DataTemplate>

class ColorEntry
{
    public string ColorName { get; set; }
    public Color Color { get; set; }

    public static SolidColorBrush Brushify(Color c)
    {
        return new SolidColorBrush(c);
    }

    public SolidColorBrush TextColor(Color c)
    {
        return new SolidColorBrush(((c.R * 0.299 + c.G * 0.587 + c.B * 0.114) > 150) ? Colors.Black : Colors.White);
    }
}

XAML 属性の使用方法

<object property="{x:Bind pathToFunction.FunctionName(functionParameter1, functionParameter2, ...), bindingProperties}" ... />

関数へのパス

関数へのパスは、他のプロパティパスと同じように指定され、関数を見つけるためにドット (.)、インデクサー、またはキャストを含めることができます。

静的関数は、XMLNamespace:ClassName.MethodName 構文を使用して指定できます。たとえば、分離コードで静的関数にバインドする場合は、次の構文を使用します。

<Page 
     xmlns:local="using:MyNamespace">
     ...
    <StackPanel>
        <TextBlock x:Name="BigTextBlock" FontSize="20" Text="Big text" />
        <TextBlock FontSize="{x:Bind local:MyHelpers.Half(BigTextBlock.FontSize)}" 
                   Text="Small text" />
    </StackPanel>
</Page>

namespace MyNamespace
{
    static public class MyHelpers
    {
        public static double Half(double value) => value / 2.0;
    }
}

また、マークアップでシステム関数を直接使用して、日付の書式設定、テキストの書式設定、テキストの連結など、シンプルなシナリオを実現することもできます。たとえば、次のようになります。

<Page 
     xmlns:sys="using:System"
     xmlns:local="using:MyNamespace">
     ...
     <CalendarDatePicker Date="{x:Bind sys:DateTime.Parse(TextBlock1.Text)}" />
     <TextBlock Text="{x:Bind sys:String.Format('{0} is now available in {1}', local:MyPage.personName, local:MyPage.location)}" />
</Page>

モードが OneWay/TwoWay である場合、関数のパスでは変更の検出が実行され、それらのオブジェクトに変更があるとバインディングが再評価されます。

バインディングされる関数には以下のことが要求されます。

コードとメタデータにアクセスできる必要があります。したがって、C# では internal/private を使用できますが、C++/CX ではメソッドをパブリック WinRT メソッドにする必要があります。
オーバーロードは引数の型ではなく数に基づき、同じ数の引数を持つ最初のオーバーロードとの一致が試みられます。
引数の型は渡されるデータと一致する必要があります。縮小変換は行われません。
関数の戻り値の型は、バインディングを使用しているプロパティの型と一致する必要があります。

バインディングエンジンでは、関数名で起動されたプロパティ変更通知に反応し、必要に応じてバインディングが再評価されます。次に例を示します。

<DataTemplate x:DataType="local:Person">
   <StackPanel>
      <TextBlock Text="{x:Bind FullName}" />
      <Image Source="{x:Bind IconToBitmap(Icon, CancellationToken), Mode=OneWay}" />
   </StackPanel>
</DataTemplate>

public class Person : INotifyPropertyChanged
{
    //Implementation for an Icon property and a CancellationToken property with PropertyChanged notifications
    ...

    //IconToBitmap function is essentially a multi binding converter between several options.
    public Uri IconToBitmap (Uri icon, Uri cancellationToken)
    {
        Uri foo = new Uri(...);        
        if (isCancelled)
        {
            foo = cancellationToken;
        }
        else 
        {
            if (this.fullName.Contains("Sr"))
            {
               //pass a different Uri back
               foo = new Uri(...);
            }
            else
            {
                foo = icon;
            }
        }
        return foo;
    }

    //Ensure FullName property handles change notification on itself as well as IconToBitmap since the function uses it
    public string FullName
    {
        get { return this.fullName; }
        set
        {
            this.fullName = value;
            this.OnPropertyChanged ();
            this.OnPropertyChanged ("IconToBitmap"); 
            //this ensures Image.Source binding re-evaluates when FullName changes in addition to Icon and CancellationToken
        }
    }
}

ヒント

x:Bind で関数を使用すると、WPF でコンバーターや MultiBinding によってサポートされていた同じシナリオを実現できます。

関数の引数

複数の関数引数をコンマ (,) で区切って指定できます。

バインディングパス – そのオブジェクトにバインドする場合と同じ構文です。
- モードが OneWay/TwoWay の場合は、変更検出が実行されて、オブジェクトが変化するとバインディングが再評価されます。
引用符で囲まれた定数文字列 – 文字列として指定するには引用符が必要です。文字列で引用符をエスケープするにはハット (^) を使用できます
定数 - たとえば -123.456
ブール値 – "x:True" または "x:False" と指定します

双方向の関数バインド

双方向のバインディングシナリオでは、逆方向のバインドのために第 2 の関数を指定する必要があります。これを行うには BindBack バインディングプロパティを使用します。次の例で、関数が受け取る必要のある引数は 1 つで、モデルにプッシュバックする必要のある値です。

<TextBlock Text="{x:Bind a.MyFunc(b), BindBack=a.MyFunc2, Mode=TwoWay}" />

次の方法で共有

x:Bind の関数

XAML 属性の使用方法

関数へのパス

関数の引数

双方向の関数バインド

関連項目

フィードバック

その他のリソース