Partilhar via

Binding.TargetNullValue Propriedade

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Data
Editar

Obtém ou define o valor usado no destino quando o valor da origem é nulo.

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>

Valor da propriedade

Object

Platform::Object

IInspectable

O valor usado no destino de associação quando o valor da origem é nulo.

Comentários

TargetNullValue pode ser usado para associações que associam uma coleção e os dados de origem usam nulo apenas para informações ausentes em alguns dos itens. Ele também pode ser usado para casos gerais em que os dados são provenientes de um banco de dados que usa valores nulos como informações de origem para significar algo, como um registro que precisa de mais informações do usuário e não está completo na origem.

Há dois padrões recomendados para usar o comportamento TargetNullValue em uma Associação:

  • A fonte de associação fornece um valor separado que é acessado por um caminho diferente, que atua como o valor singleton que pode substituir por qualquer valor nulo proveniente de um item de dados específico na origem. Por exemplo:
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

Aqui, NullValue é o caminho para o valor substituto e é referenciado por outra Associação.

  • Use recursos para fornecer um valor específico para seu aplicativo nos casos em que a fonte de dados forneceu nulo e não tem nenhuma propriedade adequada em outro caminho a ser usado como o valor de substituição. Por exemplo:
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

Aqui, AppStringForNullInAStringABinding há uma cadeia de caracteres de recurso algo como "(valor não disponível)" que permite que o usuário saiba que deve haver dados na maioria dos dados, mas esse item específico não tinha esses dados de sua origem. Use recursos para que o valor possa ser localizado.

FallbackValue é uma propriedade semelhante com cenários semelhantes. A diferença é que uma associação usa FallbackValue para casos em que o Caminho e a Origem não são avaliados na fonte de dados ou se tentar defini-la na origem com uma associação bidirecional gera uma exceção. Ele usará TargetNullValue se o Caminho for avaliado, mas o valor encontrado lá for nulo.

Não é possível 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, obterá uma exceção em tempo de execução.

Aplica-se a

Confira também