Binding.FallbackValue Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la valeur à utiliser quand la liaison ne peut pas retourner une valeur.
public:
property Platform::Object ^ FallbackValue { Platform::Object ^ get(); void set(Platform::Object ^ value); };
IInspectable FallbackValue();
void FallbackValue(IInspectable value);
public object FallbackValue { get; set; }
var object = binding.fallbackValue;
binding.fallbackValue = object;
Public Property FallbackValue As Object
<Binding FallbackValue="fallbackValue" />
- or -
<Binding>
<Binding.FallbackValue>
fallbackValue
</Binding.FallbackValue>
</Binding>
Valeur de propriété
Valeur à utiliser lorsque la liaison ne peut pas retourner une valeur.
Remarques
En règle générale, vous spécifiez FallbackValue pour les liaisons qui affichent des chaînes dans l’interface utilisateur. Dans ce cas, fallbackValue est également une chaîne. Vous pouvez utiliser une ressource pour faciliter la localisation de cette chaîne.
Si vous spécifiez une chaîne littérale pour FallbackValue, vous devez utiliser d’autres guillemets pour la valeur FallbackValue dans l’utilisation de l’extension de balisage {Binding} si votre chaîne contient des espaces, car l’utilisation de l’extension de balisage {Binding} pour un attribut est déjà entre guillemets. Par exemple : <object property="{Binding FallbackValue='A literal string'}" />
.
Si elle est utilisée dans une utilisation de l’extension de balisage {Binding} , la valeur de FallbackValue peut utiliser toutes les conversions de chaîne implicites qui sont déjà disponibles en XAML, telles que le traitement de 0 en tant que chaîne pour une liaison de chaîne ou la conversion de valeurs d’énumération. Par exemple, <object property="{Binding Path=Visibility, FallbackValue=Collapsed}" />
est valide, car l’analyseur peut évaluer la chaîne « Collapsed » et retourner Visibility.Collapsed comme secours pour une valeur Visibility .
TargetNullValue est une propriété similaire avec des scénarios similaires. La différence est qu’une liaison utilise FallbackValue dans les cas où le chemin d’accès n’évalue 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 interceptée par le moteur de liaison de données. FallbackValue est également utilisé si la valeur source est la valeur sentinelle de la propriété de dépendance DependencyProperty.UnsetValue. Une liaison utilise TargetNullValue si les valeurs Path et Source sont évaluées, 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.