Binding.FallbackValue Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Data

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é

Object

Platform::Object

IInspectable

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, la valeur de secours est également une chaîne. Vous souhaiterez peut-être utiliser une ressource afin de 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 l’utilisation d’une extension de balisage {Binding} , la valeur de FallbackValue peut utiliser toutes les conversions de chaîne implicites qui sont déjà disponibles pour XAML, telles que le traitement de 0 comme 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 « Réduit » et renvoyer Visibility.Collapsed comme secours pour une valeur De visibilité .

TargetNullValue 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 ne s’évalue pas du tout 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 qui est 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 le chemin d’accès et la source sont évalués, 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.

Voir aussi

• TargetNullValue
• Exemple de liaison de données XAML
• Présentation détaillée de la liaison de données