Binding.TargetNullValue Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Valor que se usa en el destino de enlace cuando el valor del origen es NULL.
Comentarios
TargetNullValue se puede usar para los enlaces que enlazan una colección y los datos de origen usan null para que falte información 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 tiene acceso 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 otra clase Binding.
- 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 que se usará 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 "(value 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 ruta deacceso y el origen no se evalúan en el origen de datos, 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 asociado a un elemento de destino y a una propiedad de destino. Si intenta esto, obtendrá una excepción en tiempo de ejecución.