Binding.TargetNullValue Свойство

Определение

Пространство имен:
Microsoft.UI.Xaml.Data
Изменить

Возвращает или задает значение, используемое в целевом объекте, если значение источника равно 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>

Значение свойства

Object

Platform::Object

IInspectable

Значение, используемое в целевом объекте привязки, если значение источника равно NULL.

Комментарии

TargetNullValue может использоваться для привязок, которые привязывают коллекцию, и исходные данные используют значение NULL для отсутствующих сведений только в некоторых элементах. Он также может использоваться для общих случаев, когда данные, поступающие из базы данных, использующей значения NULL в качестве исходных данных, для обозначения чего-то, например записи, требующей получения дополнительных сведений от пользователя и не завершенных в источнике.

Существует два рекомендуемых шаблона для использования поведения TargetNullValue в привязке:

  • Источник привязки предоставляет отдельное значение, к которому обращается другой путь, который выступает в качестве одноэлементного значения, которое может заменить любое значение NULL , полученное из определенного элемента данных в источнике. Рассмотрим пример.
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

NullValue Ниже приведен путь к заменяемом значению, на который ссылается другая привязка.

  • Используйте ресурсы для предоставления значения, относящееся к приложению в случаях, когда источник данных предоставил значение NULL и не имеет подходящего свойства в другом пути для использования в качестве подстановки. Рассмотрим пример.
<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

Ниже приведена строка ресурса, например "(значение недоступно)", AppStringForNullInAStringABinding которая позволяет пользователю знать, что в большинстве данных должны быть данные, но этот конкретный элемент не имеет этих данных из источника. Используйте ресурсы, чтобы можно было локализовать значение.

FallbackValue — это аналогичное свойство с аналогичными сценариями. Разница заключается в том, что привязка использует FallbackValue для случаев, когда Путь и источник не вычисляются на источнике данных вообще или если попытка задать его в источнике с двусторонней привязкой вызывает исключение. Он использует TargetNullValue, если путь вычисляет, но значение, найденное, имеет значение NULL.

Нельзя задать значения свойств объекта Binding после подключения привязки к целевому элементу и целевому свойству. При попытке этого вы получите исключение во время выполнения.

Применяется к

См. также раздел