Share via


Binding.FallbackValue Properti

Definisi

Mendapatkan atau mengatur nilai yang akan digunakan saat pengikatan tidak dapat mengembalikan nilai.

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

void FallbackValue(IInspectable value);
public object FallbackValue { get; set; }
var object = binding.fallbackValue;
binding.fallbackValue = object;
Public Property FallbackValue As Object
<Binding FallbackValue="fallbackValue" />
- or -
<Binding>
  <Binding.FallbackValue>
    fallbackValue
    </Binding.FallbackValue>
</Binding>

Nilai Properti

Object

Platform::Object

IInspectable

Nilai yang digunakan saat pengikatan tidak dapat mengembalikan nilai.

Keterangan

Biasanya Anda menentukan FallbackValue untuk pengikatan yang menampilkan string di UI. Untuk kasus ini, FallbackValue juga merupakan string. Anda mungkin ingin menggunakan sumber daya sehingga lebih mudah untuk melokalisasi string ini.

Jika Anda menentukan string literal untuk FallbackValue, Anda harus menggunakan tanda kutip alternatif untuk nilai FallbackValue dalam penggunaan ekstensi markup {Binding} jika string Anda berisi spasi, karena penggunaan ekstensi markup {Binding} untuk atribut sudah berada dalam tanda kutip. Contohnya,<object property="{Binding FallbackValue='A literal string'}" />.

Jika digunakan dalam penggunaan ekstensi markup {Binding} , nilai untuk FallbackValue dapat menggunakan konversi string implisit yang sudah tersedia untuk XAML, seperti memperlakukan 0 sebagai string untuk pengikatan string, atau mengonversi nilai enum. Misalnya, <object property="{Binding Path=Visibility, FallbackValue=Collapsed}" /> valid karena pengurai dapat mengevaluasi string "Diciutkan" dan mengembalikan Visibilitas.Diciutkan sebagai fallback untuk nilai Visibilitas .

TargetNullValue adalah properti serupa dengan skenario serupa. Perbedaannya adalah bahwa pengikatan menggunakan FallbackValue untuk kasus di mana Jalur tidak mengevaluasi pada sumber data sama sekali, atau jika mencoba mengaturnya pada sumber dengan pengikatan dua arah melemparkan pengecualian yang ditangkap oleh mesin pengikatan data. FallbackValue juga digunakan jika nilai sumber adalah nilai sentinel properti dependensi DependencyProperty.UnsetValue. Pengikatan menggunakan TargetNullValue jika Jalur dan Sumber 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.

Berlaku untuk

Lihat juga