MultiBinding

MultiBinding, tek bir hedef özelliği aynı anda birden çok kaynaktan besler. FmgLib.MauiMarkup'ta bunu normal binding'de kullandığınız property builder ile kurarsınız: .Path(...) (ya da .Getter(...)) çağrısını birden fazla kez yapın ve zinciri, toplanan değerleri birleştiren bir metotla kapatın.

new Label()
    .Text(e => e
        .Path(nameof(Person.FirstName))
        .Path(nameof(Person.LastName))
        .MultiConvert((string first, string last) => $"{first} {last}"))

Her .Path() kendi alt binding'ini açar. Ardından gelen her şey — .Source(), .BindingMode(), .StringFormat(), .Converter(), .Parameter(), .Convert(), .ConvertBack(), .FallbackValue(), .TargetNullValue() — en son açılan alt binding'e aittir. Multi… metotları ise multi binding'in tamamına aittir.

Tek bir .Path() hâlâ düz bir Binding üretir; yani sıradan binding'lerde hiçbir şey değişmez. Multi binding yalnızca ikinci bir kaynak tanımladığınızda ya da Multi… metotlarından birini çağırdığınızda devreye girer.

Değerleri birleştirmek#

MultiConvert, değerleri tanımlanma sırasıyla alır. Parametre tipleri her alt binding'in ürettiği tiple eşleşmeli, dönüş tipi ise hedef özelliğin tipi olmalıdır.

new VerticalStackLayout()
.Children(
    new Slider().Assign(out var width).Minimum(1).Maximum(300),
    new Slider().Assign(out var height).Minimum(1).Maximum(300),

    new Label()
        .Text(e => e
            .Path(nameof(Slider.Value)).Source(width)
            .Path(nameof(Slider.Value)).Source(height)
            .MultiConvert((double w, double h) => $"{w:F0} × {h:F0} = {w * h:F0} px²"))
)

2 ile 9 alt binding için overload'lar vardır. .Path() sayısı ile delege parametre sayısı uyuşmazsa hata, binding kurulurken her iki sayıyı da içeren bir mesajla bildirilir.

Tek bir kaynağı önceden dönüştürmek#

.Convert(), kendisinden önce gelen alt binding'e aittir; böylece bir kaynak MultiConvert'e ulaşmadan önce şekillendirilebilir:

new Label()
    .Text(e => e
        .Path(nameof(Person.Age)).Convert((int age) => age >= 18)
        .Path(nameof(Person.FirstName))
        .MultiConvert((bool adult, string name) => adult ? name : $"{name} (reşit değil)"))

Birinci alt binding kendi .Convert()'i sayesinde bool, ikincisi ham string gönderir. İki isim iki rolü ayırır: Convert her zaman bir path'e aittir, MultiConvert her zaman zinciri kapatır.

Converter olmadan biçimlendirme#

Birleştirme sadece biçimlendirmeden ibaretse MultiStringFormat yeterlidir:

new Label()
    .Text(e => e
        .Path(nameof(Person.FirstName))
        .Path(nameof(Person.LastName))
        .MultiStringFormat("{0} {1}"))

Derlenmiş (compiled) multi binding#

.Getter(...) derlenmiş bir alt binding açar: reflection yok, string path yok ve özellik adlarını derleyici denetler. Alt binding'ler farklı tipler üretebilir:

new Label()
    .Text(e => e
        .Getter(static (PersonViewModel vm) => vm.FirstName)
        .Getter(static (PersonViewModel vm) => vm.Age)
        .MultiConvert((string name, int age) => $"{name} ({age})"))

Derlenmiş ve string tabanlı alt binding'ler aynı multi binding içinde serbestçe karıştırılabilir; .Setter(...) de kendisinden önce gelen derlenmiş alt binding'in ters işlemini sağlamaya devam eder. Getter ifadesinin uyması gereken kurallar için bkz. Compiled Bindings.

Two-way multi binding#

MultiConvertBack, elemanları tanımlanma sırasıyla kaynağa yazılan bir tuple döndürür. Her eleman, varsa kendi alt binding'inin ConvertBack()'inden de geçer.

new Entry()
    .Text(e => e
        .Path(nameof(Person.FirstName))
        .Path(nameof(Person.LastName))
        .MultiMode(BindingMode.TwoWay)
        .MultiConvert((string first, string last) => $"{first} {last}")
        .MultiConvertBack((string full) =>
        {
            var parts = full.Split(' ');
            return (parts[0], parts.Length > 1 ? parts[1] : string.Empty);
        }))

MultiMode() multi binding'in kendi modunu belirler. Tek bir alt binding bunu kendi .BindingMode()'u ile ezebilir; two-way bir multi binding içinde bir kaynağı salt okunur tutmanın yolu budur.

Boolean toplayıcılar#

"Şunların hepsi doğruysa etkinleştir" gibi yaygın durumlarda hiç delege yazmanız gerekmez:

new Button()
    .Text("Kayıt ol")
    .IsEnabled(e => e
        .Path(nameof(SignUpViewModel.AcceptedTerms))
        .Path(nameof(SignUpViewModel.AcceptedPrivacy))
        .Path(nameof(SignUpViewModel.IsEmailVerified))
        .MultiAll())

bool tipinde bir özellik için geçerlidirler ve her alt binding'in bool üretmesini beklerler — doğrudan ya da o alt binding'in kendi .Convert()'i üzerinden:

new Button()
    .IsEnabled(e => e
        .Path(nameof(Entry.Text)).Source(nameEntry).Convert((string s) => !string.IsNullOrWhiteSpace(s))
        .Path(nameof(Entry.Text)).Source(mailEntry).Convert((string s) => !string.IsNullOrWhiteSpace(s))
        .MultiAll())

Toplayıcılar herhangi bir sayıda alt binding ile çalıştığı için sayı doğrulanmaz: iki alt binding üzerinde MultiAtLeast(3) her zaman false verir.

Sayısı önceden belli olmayan alt binding'ler#

Alt binding'ler bir döngüde üretiliyorsa ve sayıları önceden bilinmiyorsa MultiConvertRaw kullanın. Tipli biçim, her değeri tek bir tipe açar ve uyuşmazlığı MultiConvert ile aynı şekilde raporlar:

new Label()
    .Text(e => e
        .Path("Basket.Food").Convert((decimal v) => (double)v)
        .Path("Basket.Drinks").Convert((decimal v) => (double)v)
        .Path("Basket.Delivery").Convert((decimal v) => (double)v)
        .MultiConvertRaw<double>(values => values.Sum().ToString("C")))

Tipsiz biçim size ham object?[] dizisini tanımlanma sırasıyla verir; dönüşümler sizin sorumluluğunuzdadır:

.MultiConvertRaw(
    values => Describe(values),
    value => Split(value))

Multi binding metotları#

Değerler henüz gelmemişken#

Multi binding, alt binding'lerden ilki çözülür çözülmez değerlendirilir; bu sırada diğer yuvalar hâlâ boş olabilir. Bu durumda hedef özellik null ile ezilmek yerine mevcut değerini korur: herhangi bir alt binding çözülmemişken ya da kaynak null iken ve karşılık gelen delege parametresi nullable olmayan bir value type iken güncelleme atlanır. Parametrenin kabul ettiği bir null (string, nullable value type, herhangi bir referans tipi) her zamanki gibi iletilir.

Bir delege parametresi, binding'in hiç üretmediği bir tiple tanımlanmışsa fırlatılan hata; MAUI binding altyapısının içinde bir yerde patlamak yerine özelliği, sorunlu path'i ve değerin sırasını isimleriyle bildirir.

Kendi IMultiValueConverter'ınızı kullanmak#

new CheckBox()
    .IsChecked(e => e
        .Path("Employee.IsOver16")
        .Path("Employee.HasPassedTest")
        .Path("Employee.IsSuspended").Convert((bool suspended) => !suspended)
        .MultiConverter(new AllTrueMultiConverter())
        .MultiFallbackValue(false))

public class AllTrueMultiConverter : IMultiValueConverter
{
    public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture)
    {
        if (values == null || values.Any(v => v is not bool))
            return BindableProperty.UnsetValue;

        return values.OfType<bool>().All(b => b);
    }

    public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture)
        => throw new NotSupportedException();
}

BindableProperty.UnsetValue döndürmek binding'i MultiFallbackValue'ya düşürür.

Hazır BindingBase nesneleri#

Elinizde nesne olarak bulunan alt binding'ler — Binding.Create ile oluşturulan derlenmiş binding'ler dâhil — .Bindings(...) ile eklenebilir:

new CheckBox()
    .IsChecked(e => e
        .Bindings(
            Binding.Create(static (MainPageViewModel vm) => vm.IsOver16),
            Binding.Create(static (MainPageViewModel vm) => vm.HasPassedTest))
        .MultiConvert((bool over16, bool passed) => over16 && passed))

Zincire .Bindings(...) ile başlamak, hazır alt binding'lere ayrılmış bir builder açar. Buradaki .Converter(IMultiValueConverter), .Parameter(), .StringFormat(), .BindingMode(), .FallbackValue() ve .TargetNullValue() doğrudan multi binding'e uygulanır; dolayısıyla önceki sürümlere göre yazılmış kod değişmeden çalışmaya devam eder:

new CheckBox()
    .IsChecked(e => e
        .Bindings(
            new Binding().Path("Employee.IsOver16"),
            new Binding().Path("Employee.HasPassedTest"))
        .Converter(new AllTrueMultiConverter())
        .FallbackValue(false))

MultiConvert, MultiConvertBack, MultiConvertRaw ve boolean toplayıcılar burada da kullanılabilir; yani converter sınıfı yazmak hiçbir zaman zorunlu değildir. Yeni kodda .Path() / .Getter() tercih edin: değerler tipli kalır ve her kaynak tek tek şekillendirilebilir.

Bind() ile tipli multi binding#

Alt seviyedeki Bind() extension'ının 2, 3 veya 4 kaynak için, değerleri tuple olarak veren tipli overload'ları da vardır:

new Label()
    .Bind<Label, string, string, string>(Label.TextProperty,
        new Binding("FirstName"),
        new Binding("LastName"),
        convert: n => $"{n.Item1} {n.Item2}")

converterParameter ve two-way senaryolar için convertBack alan varyantları da mevcuttur.

Ne zaman MultiBinding kullanmalı?#

• Hedef özellik gerçekten bağımsız olarak değişen birden çok kaynağa bağlıysa.
• View model'e hesaplanmış bir özellik ekleyemiyorsanız (ya da eklemek istemiyorsanız).

Aksi hâlde PropertyChanged tetikleyen hesaplanmış bir view model özelliği tercih edin — test etmesi ve hata ayıklaması binding tesisatından kolaydır.

Önceki sürümlerden geçiş#

Multi binding API'si 10.2.0 ile geldi; tekil binding'ler tamamen eskisi gibi davranır. Dört çağrı biçimi değişti:

Dokümantasyon boyunca kullanılan, tiplerin çıkarsandığı biçim hiç değişmedi; yalnızca açıkça yazılmış tip argümanlarının kaldırılması ya da tamamlanması gerekiyor, çünkü bu metotların her biri artık ürettiği değer için ikinci bir tip parametresi taşıyor.

İki davranış da değişti; ikisi de daha önce sessizce yanlış çalışan durumlardı:

• .Path()'i iki kez çağırmak eskiden yalnızca son path'i tutuyordu. Artık iki alt binding açar ve birleştirme metodu olmayan bir multi binding, kurulurken bunu bildirir.
• Aynı alt binding'de .Converter(...) ile .Convert(...)'ı birlikte kullanmak eskiden birini diğerinin üzerine sessizce yazıyordu; artık hata fırlatır.

İlgili Konular#

• Property Bindings
• Binding Converters
• Compiled Bindings