Binding.FallbackValue Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Data

Obtém ou define o valor a ser usado quando a associação não é capaz de retornar um valor.

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>

Valor da propriedade

Object

Platform::Object

IInspectable

O valor a ser usado quando a associação não puder retornar um valor.

Comentários

Normalmente, você especifica FallbackValue para associações que exibem cadeias de caracteres na interface do usuário. Nesse caso, FallbackValue também é uma cadeia de caracteres. Talvez você queira usar um recurso para que seja mais fácil localizar essa cadeia de caracteres.

Se você especificar uma cadeia de caracteres literal para FallbackValue, deverá usar aspas alternativas para o valor FallbackValue no uso da extensão de marcação {Binding} se a cadeia de caracteres contiver espaços, pois o uso da extensão de marcação {Binding} para um atributo já está entre aspas. Por exemplo, <object property="{Binding FallbackValue='A literal string'}" />.

Se usado em um uso de extensão de marcação {Binding} , o valor de FallbackValue pode usar quaisquer conversões de cadeia de caracteres implícitas que já estejam disponíveis para XAML, como tratar 0 como uma cadeia de caracteres para uma associação de cadeia de caracteres ou converter valores de enumeração. Por exemplo, <object property="{Binding Path=Visibility, FallbackValue=Collapsed}" /> é válido porque o analisador pode avaliar a cadeia de caracteres "Recolhido" e retornar Visibility.Collapsed como o fallback de um valor visibility .

TargetNullValue é uma propriedade semelhante com cenários semelhantes. A diferença é que uma associação usa FallbackValue para casos em que o Caminho não é avaliado na fonte de dados ou se tentar defini-la na origem com uma associação bidirecional gera uma exceção capturada pelo mecanismo de associação de dados. FallbackValue também será usado se o valor de origem for o valor de sentinela da propriedade de dependência DependencyProperty.UnsetValue. Uma associação usará TargetNullValue se o Caminho e a Origem forem avaliados, mas o valor encontrado lá for nulo.

Você não pode definir os valores de propriedade de um objeto Binding depois que essa associação tiver sido anexada a um elemento de destino e à propriedade de destino. Se você tentar isso, receberá uma exceção em tempo de execução.

Confira também

• TargetNullValue
• Exemplo de associação de dados XAML
• Vinculação de dados em detalhes