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, если значение Path вычисляется, но найденное там значение равно NULL.

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

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

• FallbackValue
• Пример привязки данных XAML
• Подробно о привязке данных