dataBinding(データバインディング)

[LeoAndo]

基本的な概念

• ２つのオブジェクトのプロパティ同士の接続はdatabindingと呼ばれるXamarin.Formsの強力な機能を使って自動化できる

• dataBindingは内部でイベントハンドラーをインストールすることでpropertyからpropertyへの値の転送を処理する
• ほとんどの場合、dataBindingはxamlファイルで定義する
• dataBindingはMVVM(Model-View-ViewModel)アプリケーションアーキテクチャでも重要な役割を果たす。dataBindingはModelとViewModelのデータをViewにリンクする(ここでいうViewはUser interfaceのことでxamlを指す)
• 基本的な概念として、dataBindingには常にソースとターゲットが存在する

refs

https://docs.microsoft.com/ja-jp/xamarin/xamarin-forms/creating-mobile-apps-xamarin-forms/summaries/chapter16

[LeoAndo]

ターゲット、ソースに関してのルール

"ターゲット" プロパティは BindableProperty によってサポートされている必要がある "ソース" プロパティは、通常、INotifyPropertyChanged を実装するクラスのメンバー(BindableObject では INotifyPropertyChanged が実装されている)

[LeoAndo]

dataBindingをコードで定義する方法 (唯一の方法ではない)

• ターゲットオブジェクトのBindingContextpropertyをソースオブジェクトを参照するように設定する
• ターゲットオブジェクトでSetBindingメソッドを呼び出し、引数としてtargetPropertyとsourcePropertyを渡す

[LeoAndo]

BindingContext

• BindingContextはビジュアルツリー(View階層)全体に伝播される　つまり、StackLayoutに対して設定されたBindingContextプロパティは、そのStackLayoutの配下にある全ての子Viewに適用される

[LeoAndo]

BindingModeについて

通常は、dataBindingはソースプロパティの値をターゲットプロパティに設定するが、 データの流れがそれほど明確でないこともある。

ターゲットとソースの関係は、BindingMode列挙型のメンバーによって定義されている。

• Default
• OneWay
  • ソースの変化がターゲットに影響を与える
• OneWayToSource
  • ターゲットの変化がソースに影響を与える
• TwoWay
  • ソースとターゲットの変化がお互いに影響を与え合う

ほとんどのBindingPropertyのデフォルトのBindingModeはOneWayだが、 例外がいくつかあり、デフォルトがTwoWayのプロパティを持つものもある

クラス	TwoWayであるプロパティ
Slider	Value
Stepper	Value
Switch	IsToggled
Entry	Text
Editor	Text
SearchBar	Text
DatePicker	Date
TimePicker	Time

[LeoAndo]

文字列の書式設定

Bindingクラスには、StringFromatというプロパティが定義されています。 このプロパティを利用すれば、.NETの書式設定文字列全体をカバーできる。 StringFormatに指定する書式文字列は、プレースホールダー"{0}"と、ソースデータ型に適した書式設定を含んでいなければならない。

例えば、小数点以下３桁のdouble型の値を表示するには"{0:F3"}"を指定する。

[LeoAndo]

dataBindingの値コンバーター

dataBindingで型変換や値変換が必要な場合は、IValueConverterを実装したクラスを使う

Pull Request