Binding.TargetNullValue Propiedad

Definición

Espacio de nombres:

Microsoft.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 puede usarse para enlaces que enlazan una colección y los datos de origen usan null para la falta de información solo en algunos de los elementos. También se puede usar para 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 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 la rutade acceso y el origen no se evalúan en el origen de datos en absoluto, o si intenta establecerlo en el origen con un enlace bidireccional produce una excepción. Usa TargetNullValue si path realiza la evaluación, pero el valor encontrado es NULL.

No se pueden establecer los valores de propiedad de un objeto Binding después de que el enlace se haya asociado 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