Binding.FallbackValue Propriété

Définition

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

Obtient ou définit la valeur à utiliser lorsque 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. Pour ce cas, fallbackValue est également une chaîne. Vous souhaiterez peut-être utiliser une ressource afin qu’il soit plus facile de localiser 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 se trouve 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 comme une 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 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 n’est pas évalué sur la source de données du tout, 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 sentinel de propriété de dépendance DependencyProperty.UnsetValue. Une liaison utilise TargetNullValue si le chemin d’accès et la source évaluent, 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