Binding.TargetNullValue Property

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

Syntax


public object TargetNullValue { get; set; }


<Binding TargetNullValue="nullValueString" />



<Binding>
  <Binding.TargetNullValue>
    nullValue
  </Binding.TargetNullValue>
</Binding>


XAML Values

nullValueString

Eine Zeichenfolge, die konvertiert werden kann, um einen Wert für das Binding-Ziel in XAML bereitzustellen, wenn die Quelle null war.

nullValue

Eine Objektelementinstanz, die einen Wert für das Binding-Ziel in XAML bereitstellen kann, wenn die Quelle null war.

Eigenschaftswert

Typ: System.Object [.NET] | Platform::Object [C++]

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 zeigen dann mit null nur die fehlenden Informationen in einigen Elementen an. Außerdem kann es für allgemeine Zwecke verwendet werden, bei denen Daten aus einer Datenbank, die null-Werte als Quellinformationen verwendet, einen Wert angeben, wie einen Datensatz, der weitere Informationen vom Benutzer erfordert und in der Quelle nicht abgeschlossen ist.

Es gibt zwei empfohlene Muster für die Verwendung von TargetNullValue-Verhalten in einer Binding:

  • Die Bindungsquelle stellt einen separaten Wert zur Verfügung, auf den über einen anderen Pfad zugegriffen wird. Dieser Wert tritt als Singletonwert auf und kann jeden von einem bestimmten Datenelement in der Quelle stammenden null-Wert ersetzen. Beispiel:
    
    <Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}" />
    
    
    Hier NullValue ist der Pfad zum Ersatzwert und ein anderes Binding verweist auf ihn.
  • Verwenden Sie Ressourcen, um einen Wert bereitzustellen, der für Ihre App bestimmt ist, wenn die Datenquelle null bereitstellt und keine geeignete Eigenschaft unter einem anderen Pfad aufweist, die als Ersatzwert verwendet werden kann. Beispielsweise wird der Benutzer
    
    <Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}" />
    
    
    hier AppStringForNullInAStringABinding mit einer Ressourcenzeichenfolge wie "(Wert nicht verfügbar)" darüber informiert, dass Daten in den meisten Daten vorhanden sein sollten, dieses Element jedoch über keine 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 ist, dass eine Bindung FallbackValue für Fälle verwendet, in denen Path und Source in der Datenquelle überhaupt nicht ausgewertet werden, oder beim Versuch, den Wert in der Quelle mit einer bidirektionalen Bindung festzulegen, eine Ausnahme ausgelöst wird. Sie verwendet TargetNullValue, wenn Path ausgewertet wird, der Wert, der dort gefunden wird, jedoch null lautet.

Sie können die Eigenschaftswerte eines Binding-Objekts nicht festlegen, nachdem die Bindung an ein Zielelement und eine Zieleigenschaft angefügt wurde. Wenn Sie dies versuchen, wird eine Laufzeitausnahme ausgelöst.

Anforderungen

Mindestens unterstützter Client

Windows 8.1

Mindestens unterstützter Server

Windows Server 2012 R2

Namespace

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Metadaten

Windows.winmd

Siehe auch

Binding
FallbackValue
Beispiel für XAML-Datenbindung
Übersicht über die Datenbindung

 

 

Anzeigen:
© 2014 Microsoft