Binding.TargetNullValue Eigenschaft

Definition

Namespace:
Microsoft.UI.Xaml.Data
Bearbeiten

Dient zum Abrufen oder Festlegen des Werts, der im Ziel verwendet wird, wenn der Wert der Quelle null ist.

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>

Eigenschaftswert

Object

Platform::Object

IInspectable

Der Wert, der im Bindungsziel verwendet wird, wenn der Wert der Quelle null ist.

Hinweise

TargetNullValue kann für Bindungen verwendet werden, die eine Auflistung binden und die Quelldaten null für fehlende Informationen nur in einigen Elementen verwenden. Es kann auch für allgemeine Fälle verwendet werden, in denen die Daten aus einer Datenbank stammen, die NULL-Werte als Quellinformationen verwendet, um etwas zu kennzeichnen, z. B. einen Datensatz, der weitere Informationen vom Benutzer benötigt und nicht vollständig in der Quelle ist.

Es gibt zwei empfohlene Muster für die Verwendung des TargetNullValue-Verhaltens in einer Bindung:

  • Die Bindungsquelle stellt einen separaten Wert bereit, der von einem anderen Pfad aufgerufen wird, der als Singletonwert fungiert, der durch einen beliebigen Nullwert ersetzt werden kann, der von einem bestimmten Datenelement in der Quelle stammt. Beispiel:
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

NullValue Hier ist der Pfad zum Ersatzwert und wird von einer anderen Bindung referenziert.

  • Verwenden Sie Ressourcen, um einen wert bereitzustellen, der für Ihre App spezifisch ist, in Fällen, in denen die Datenquelle null bereitgestellt hat und keine geeignete Eigenschaft in einem anderen Pfad aufweist, der als Ersetzungswert verwendet werden soll. Beispiel:
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

AppStringForNullInAStringABinding Hier ist eine Ressourcenzeichenfolge wie "(Wert nicht verfügbar)", mit der der Benutzer wissen kann, dass es in den meisten Daten Daten geben sollte, aber dieses bestimmte Element hat diese Daten nicht aus seiner Quelle. Verwenden Sie Ressourcen, damit der Wert lokalisiert werden kann.

FallbackValue ist eine ähnliche Eigenschaft mit ähnlichen Szenarien. Der Unterschied besteht darin, dass eine Bindung FallbackValue für Fälle verwendet, in denen der Pfad und die Quelle überhaupt nicht für die Datenquelle ausgewertet werden, oder wenn Sie versuchen, sie für die Quelle mit einer bidirektionale Bindung festzulegen, eine Ausnahme auslöst. Es verwendet TargetNullValue, wenn der Pfad ausgewertet wird, aber der gefundene Wert null ist.

Sie können die Eigenschaftswerte eines Binding-Objekts nicht festlegen, nachdem diese Bindung an ein Zielelement und eine Zieleigenschaft angefügt wurde. Wenn Sie dies versuchen, erhalten Sie eine Laufzeit ausnahme.

Gilt für:

Weitere Informationen