Binding.TargetNullValue Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Data

Ruft den Wert ab, der im Ziel verwendet wird, wenn der Wert der Quelle NULL ist, oder legt diesen fest.

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 Sammlung binden, und die Quelldaten verwenden NULL nur für fehlende Informationen in einigen Elementen. 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 in der Quelle nicht vollständig ist.

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

• Die Bindungsquelle stellt einen separaten Wert bereit, auf den über einen anderen Pfad zugegriffen wird, der als Singletonwert fungiert, der jeden NULL-Wert ersetzen 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, auf den eine andere Bindung verweist.

• Verwenden Sie Ressourcen, um einen Wert bereitzustellen, der für Ihre App spezifisch ist, wenn die Datenquelle NULL bereitgestellt hat und keine geeignete Eigenschaft in einem anderen Pfad aufweist, der als Ersetzungswert verwendet werden kann. Beispiel:

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

AppStringForNullInAStringABinding Hier ist eine Ressourcenzeichenfolge wie "(Wert nicht verfügbar)", die den Benutzer darüber informiert, dass in den meisten Daten Daten vorhanden sein sollten, dieses bestimmte Element jedoch nicht über diese Daten aus seiner Quelle verfügt. 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 Pfad und Quelle überhaupt nicht für die Datenquelle ausgewertet werden oder wenn versucht wird, sie für die Quelle mit einer bidirektionalen Bindung festzulegen, eine Ausnahme auslöst. Es wird TargetNullValue verwendet, wenn der Pfad ausgewertet wird, aber der dort 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.

Weitere Informationen

• FallbackValue
• XAML-Datenbindungsbeispiel
• Datenbindung im Detail