PriorityBinding PriorityBinding PriorityBinding PriorityBinding Class

Определение

Описывает коллекцию объектов Binding, присоединенную к одному свойству целевого объекта привязки, получающему значение из первой привязки в коллекции, которая успешно создает значение.Describes a collection of Binding objects that is attached to a single binding target property, which receives its value from the first binding in the collection that produces a value successfully.

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild
Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild
Наследование
Атрибуты
Реализации

Комментарии

PriorityBinding позволяет связать со списком привязки (цель) целевое свойство привязки.PriorityBinding lets you associate a binding target (target) property with a list of bindings. Первой привязки, возвращается значение становится активной привязки.The first binding that returns a value successfully becomes the active binding.

Привязка успешно возвращает значение, если:A binding returns a value successfully if:

  1. Путь к источнику привязки разрешает успешно.The path to the binding source resolves successfully.

  2. Преобразователь значений, если таковой имеется, способен преобразовать полученное значение.The value converter, if any, is able to convert the resulting value.

  3. Полученное значение является допустимым для целевого свойства.The resulting value is valid for the target property.

Значение DependencyProperty.UnsetValue не считается успешной возвращаемое значение.The value DependencyProperty.UnsetValue is not considered a successful return value.

Приоритет привязки определяется согласно порядку их следования в списке.The priority of the bindings is determined by their order in the list. Привязка, занимающий первую позицию в списке имеет наивысший приоритет.The binding that appears first in the list has the highest priority.

Обработчик привязки начинается с первой привязки в списке и проверяет, ли она возвращает значение успешно; в этом случае используется значение данной привязки.The binding engine starts with the first binding in the list and verifies whether that binding returns a value successfully; if it does, the value from that binding is used. Если первой привязки не будет успешно возвращено значение, обработчик привязки проверяет второй привязки, чтобы определить, является ли он успешно; возвращает значение в этом случае значение вторая привязка становится активным.If the first binding does not return a value successfully, the binding engine examines the second binding to determine whether it returns a value successfully; if it does, the value from the second binding becomes the active value. Процесс проверки продолжается до конца списка привязок.This verification process continues to the end of the list of bindings. Если ни одна из привязок успешно возвращает значение, привязка использует FallbackValue.If none of the bindings returns a value successfully, the binding uses the FallbackValue.

Обработчик привязки продолжает отслеживать изменения для всех привязок.The binding engine continues to listen for changes on all bindings. Если в любой момент одну из привязок, которые имеет более высокий приоритет успешно возвращает значение, значение для этой привязки становится активным и заменяет текущее значение.If at any point one of the bindings that has a higher priority returns a value successfully, the value for that binding becomes the active value and replaces the current value.

Конструкторы

PriorityBinding() PriorityBinding() PriorityBinding() PriorityBinding()

Инициализирует новый экземпляр класса PriorityBinding.Initializes a new instance of the PriorityBinding class.

Свойства

BindingGroupName BindingGroupName BindingGroupName BindingGroupName

Возвращает или задает имя группы BindingGroup, к которой принадлежит данная привязка.Gets or sets the name of the BindingGroup to which this binding belongs.

(Inherited from BindingBase)
Bindings Bindings Bindings Bindings

Получает коллекцию объектов Binding, созданную для экземпляра PriorityBinding.Gets the collection of Binding objects that is established for this instance of PriorityBinding.

Delay Delay Delay Delay

Получает или задает время (в миллисекундах) ожидания перед обновлением источника привязки после изменения значения в целевом объекте.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Inherited from BindingBase)
FallbackValue FallbackValue FallbackValue FallbackValue

Возвращает или задает значение, которое необходимо использовать, если привязка неспособна вернуть значение.Gets or sets the value to use when the binding is unable to return a value.

(Inherited from BindingBase)
StringFormat StringFormat StringFormat StringFormat

Возвращает или задает строку, указывающую способ форматирования привязки при отображении связанного значения в виде строки.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Inherited from BindingBase)
TargetNullValue TargetNullValue TargetNullValue TargetNullValue

Возвращает или задает значение, используемое в целевом элементе, если значение источника равно null.Gets or sets the value that is used in the target when the value of the source is null.

(Inherited from BindingBase)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider)

Возвращает объект, который необходимо задать для свойства при применении данной привязки и расширения.Returns an object that should be set on the property where this binding and extension are applied.

(Inherited from BindingBase)
ShouldSerializeBindings() ShouldSerializeBindings() ShouldSerializeBindings() ShouldSerializeBindings()

Возвращает значение, определяющее, должны ли процессы сериализации выполнять сериализацию действующего значения свойства Bindings по экземплярам данного класса.Returns a value that indicates whether serialization processes should serialize the effective value of the Bindings property on instances of this class.

ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue()

Возвращает значение, определяющее, должны ли процессы сериализации выполнять сериализацию действующего значения свойства FallbackValue по экземплярам данного класса.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Inherited from BindingBase)
ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue()

Возвращает значение, которое указывает, должно ли свойство TargetNullValue быть сериализовано.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Inherited from BindingBase)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

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

Дополнительно