Binding.TargetNullValue Propriété

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 des é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 signer quelque chose, tel qu’un enregistrement qui nécessite plus d’informations de l’utilisateur et qui n’est pas terminé 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 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}}"/>

NullValue Voici le chemin d’accès à la valeur de remplacement 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 à utiliser comme valeur de substitution. Par exemple:
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

AppStringForNullInAStringABinding Voici une chaîne de ressource semblable à « (valeur non disponible) » qui permet à l’utilisateur de savoir qu’il doit y avoir des données dans la plupart des données, mais cet élément particulier n’a pas ces données à partir de sa source. Utilisez des ressources pour 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 du tout, ou si vous tentez de le définir sur la source avec une liaison bidirectionnelle lève une exception. Elle utilise TargetNullValue si le chemin d’accès évalue, mais 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