Share via

Binding.TargetNullValue Propriété

  • Référence

Définition

Espace de noms:
Microsoft.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é pour 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 d’informations supplémentaires de la part de l’utilisateur et qui n’est pas complet dans la source.

Il est recommandé d’utiliser le 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 la 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 aucune 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 quelque chose 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 FallbackValue pour les cas où le chemin d’accès et la source ne sont pas évalués sur 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 est évalué, mais que la valeur trouvée est null.

Vous ne pouvez pas définir les valeurs de propriété d’un objet Binding une fois 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