Binding.TargetNullValue Property

Obtiene o establece el valor que se utiliza en el destino cuando el valor del origen es null.

Sintaxis


public object TargetNullValue { get; set; }


<Binding TargetNullValue="nullValueString" />



<Binding>
  <Binding.TargetNullValue>
    nullValue
  </Binding.TargetNullValue>
</Binding>


XAML Values

nullValueString

Una cadena que se puede convertir para proporcionar un valor para el destino de Binding en XAML, en caso de que el origen fuera null.

nullValue

Una instancia del elemento de objeto que puede proporcionar un valor para el destino de Binding en XAML, en caso de que el origen fuera null.

Valor de propiedades

Tipo: System.Object [.NET] | Platform::Object [C++]

Valor que se usa en el destino del enlace cuando el valor del origen es null.

Comentarios

TargetNullValue se puede utilizar para enlaces que vinculan una colección y los datos de origen utilizan null para la información que falta únicamente en algunos de los elementos. También se puede utilizar para casos generales donde los datos proceden de una base de datos que usa valores null como información de origen para indicar algo, como es el caso de un registro que necesita más información del usuario y no está completo en el origen.

Hay dos patrones recomendados para utilizar el comportamiento de TargetNullValue en Binding:

  • El origen del enlace proporciona un valor independiente al que se tiene acceso mediante otra ruta de acceso, que actúa como el valor singleton que puede sustituir a cualquier valor null que proceda de un elemento de datos específico en el origen. Por ejemplo:
    
    <Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}" />
    
    
    aquí, NullValue es la ruta de acceso al valor sustituto y a la que se hace referencia por otro Binding.
  • Utilice recursos para proporcionar un valor específico de su aplicación en caso de que el origen de datos haya proporcionado null y no tenga ninguna propiedad adecuada en otra ruta de acceso para utilizar como valor de sustitución. Por ejemplo,
    
    <Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}" />
    
    
    aquí AppStringForNullInAStringABinding encontrará una cadena de recursos similar a "(valor no disponible)" que informa al usuario de la existencia de datos en la mayoría de los casos, pero que en ese elemento en particular no había datos de origen. Utilice recursos para encontrar el valor.

FallbackValue es una propiedad similar con escenarios similares. La diferencia es que un enlace utiliza FallbackValue para los casos donde las propiedades Path y Source no se evalúan en el origen de datos en absoluto, o si al intentar establecerlas en el origen con un enlace bidireccional se produce una excepción. Utiliza TargetNullValue si la propiedad Path evalúa, pero el valor encontrado es null.

No puede establecer los valores de propiedad de un objeto Binding después que el enlace se haya adjuntado a un elemento de destino y una propiedad de destino. Si lo intenta, obtendrá una excepción en tiempo de ejecución.

Requisitos

Cliente mínimo admitido

Windows 8.1

Servidor mínimo admitido

Windows Server 2012 R2

Espacio de nombres

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Metadatos

Windows.winmd

Vea también

Binding
FallbackValue
Ejemplo de enlace de datos XAML
Introducción al enlace de datos

 

 

Mostrar:
© 2014 Microsoft