Binding.TargetNullValue Propriété

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml.Data
Modifier

Obtient ou définit la valeur utilisée dans la cible lorsque la valeur de la source est 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>

Valeur de propriété

Object

Platform::Object

IInspectable

Valeur utilisée dans la cible de liaison lorsque la valeur de la source est null.

Remarques

TargetNullValue peut être utilisé pour les liaisons qui lient une collection et les données sources utilisent null pour les informations manquantes uniquement dans certains éléments. Il peut également être utilisé dans les cas généraux où les données proviennent d’une base de données qui utilise des valeurs Null comme informations sources pour signifier quelque chose, par exemple un enregistrement qui a besoin de plus d’informations de l’utilisateur et qui n’est pas complet dans la source.

Il existe deux modèles recommandés pour l’utilisation du comportement TargetNullValue dans une liaison :

  • La source de liaison fournit une valeur distincte accessible par un chemin d’accès différent, qui agit comme valeur singleton qui peut remplacer toute valeur null provenant d’un élément de données spécifique dans la source. Par exemple :
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

Ici, NullValue est le chemin d’accès à la valeur de substitution et est référencé par une autre liaison.

  • Utilisez des ressources pour fournir une valeur spécifique à votre application dans les cas où la source de données a fourni null et n’a pas de propriété appropriée dans un autre chemin d’accès à utiliser comme valeur de substitution. Par exemple :
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

Ici, AppStringForNullInAStringABinding est une chaîne de ressource comme « (valeur non disponible) » qui permet à l’utilisateur de savoir qu’il doit y avoir des données dans la plupart des données, mais que cet élément particulier n’avait pas ces données de sa source. Utilisez des ressources afin que la valeur puisse être localisée.

FallbackValue est une propriété similaire avec des scénarios similaires. La différence est qu’une liaison utilise FallbackValuedans les cas où path et source n’évaluent pas du tout la source de données, ou si la tentative de la définir sur la source avec une liaison bidirectionnelle lève une exception. Il utilise TargetNullValue si le chemin d’accès effectue une évaluation, mais que la valeur trouvée est null.

Vous ne pouvez pas définir les valeurs de propriété d’un objet Binding après que cette liaison a été attachée à un élément cible et à une propriété cible. Si vous tentez cette opération, vous obtiendrez une exception d’exécution.

S’applique à

Voir aussi