Binding.TargetNullValue Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Data

Obtiene o establece el valor que se usa en el destino cuando el valor del origen es NULL.

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 de propiedad

Object

Platform::Object

IInspectable

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

Comentarios

TargetNullValue se puede usar para enlaces que enlazan una colección y los datos de origen usan NULL para la información que falta solo en algunos de los elementos. También se puede usar en casos generales en los que los datos proceden de una base de datos que usa valores NULL como información de origen para indicar algo, como un registro que necesita más información del usuario y no se completa en el origen.

Hay dos patrones recomendados para usar el comportamiento TargetNullValue en un enlace:

• El origen de enlace proporciona un valor independiente al que accede una ruta de acceso diferente, que actúa como el valor singleton que puede sustituir por cualquier valor NULL procedente de un elemento de datos específico del 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 se hace referencia a ella por otro enlace.

• Use los recursos para proporcionar un valor específico de la aplicación en los casos en los que el origen de datos proporcionó null y no tiene ninguna propiedad adecuada en otra ruta de acceso para usarla como valor de sustitución. Por ejemplo:

<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

Aquí, AppStringForNullInAStringABinding es una cadena de recursos similar a "(valor no disponible)" que permite al usuario saber que debe haber datos allí en la mayoría de los datos, pero este elemento en particular no tenía esos datos de su origen. Use recursos para que el valor se pueda localizar.

FallbackValue es una propiedad similar con escenarios similares. La diferencia es que un enlace usa FallbackValue para los casos en los que path y source no se evalúan en el origen de datos en absoluto, o si se intenta establecer en el origen con un enlace bidireccional se produce una excepción. Usa TargetNullValue si la ruta de acceso se evalúa, pero el valor encontrado es NULL.

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

Consulte también

• FallbackValue
• Ejemplo de enlace de datos XAML
• Enlace de datos en profundidad