Binding.TargetNullValue Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Data

Mendapatkan atau mengatur nilai yang digunakan dalam target saat nilai sumber null.

public:
 property Platform::Object ^ TargetNullValue { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable TargetNullValue();

void TargetNullValue(IInspectable value);

public object TargetNullValue { get; set; }

var object = binding.targetNullValue;
binding.targetNullValue = object;

Public Property TargetNullValue As Object

<Binding TargetNullValue="nullValueString" />
- or -
<Binding>
  <Binding.TargetNullValue>
    nullValue
  </Binding.TargetNullValue>
</Binding>

Nilai Properti

Object

Platform::Object

IInspectable

Nilai yang digunakan dalam target pengikatan saat nilai sumber null.

Keterangan

TargetNullValue mungkin digunakan untuk pengikatan yang mengikat koleksi dan data sumber menggunakan null untuk info yang hilang hanya di beberapa item. Ini mungkin juga digunakan untuk kasus umum di mana data berasal dari database yang menggunakan nilai null sebagai info sumber untuk menandakan sesuatu, seperti rekaman yang membutuhkan info lebih lanjut dari pengguna dan tidak lengkap di sumbernya.

Ada dua pola yang direkomendasikan untuk menggunakan perilaku TargetNullValue dalam Pengikatan:

• Sumber pengikatan menyediakan nilai terpisah yang diakses oleh jalur yang berbeda, yang bertindak sebagai nilai singleton yang dapat menggantikan nilai null apa pun yang berasal dari item data tertentu di sumbernya. Contohnya:

<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

Di sini, NullValue adalah jalur ke nilai pengganti, dan dirujuk oleh Pengikatan lain.

• Gunakan sumber daya untuk memberikan nilai yang khusus untuk aplikasi Anda jika sumber data yang disediakan null dan tidak memiliki properti yang cocok di jalur lain untuk digunakan sebagai nilai substitusi. Contohnya:

<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

Di sini, AppStringForNullInAStringABinding adalah string sumber daya seperti "(nilai tidak tersedia)" yang memungkinkan pengguna tahu bahwa harus ada data di sebagian besar data tetapi item khusus ini tidak memiliki data tersebut dari sumbernya. Gunakan sumber daya sehingga nilai dapat dilokalkan.

FallbackValue adalah properti serupa dengan skenario serupa. Perbedaannya adalah bahwa pengikatan menggunakan FallbackValue untuk kasus di mana Jalur dan Sumber tidak mengevaluasi sumber data sama sekali, atau jika mencoba mengaturnya pada sumber dengan pengikatan dua arah memberikan pengecualian. Ini menggunakan TargetNullValue jika Jalur mengevaluasi, tetapi nilai yang ditemukan ada null.

Anda tidak dapat mengatur nilai properti objek Pengikatan setelah pengikatan tersebut dilampirkan ke elemen target dan properti target. Jika Anda mencoba ini, Anda akan mendapatkan pengecualian run-time.

Lihat juga

• FallbackValue
• Sampel pengikatan data XAML
• Pengikatan data secara mendalam