FrameworkPropertyMetadata.IsNotDataBindable Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, поддерживает ли свойство зависимостей привязку данных.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };
public bool IsNotDataBindable { get; set; }
member this.IsNotDataBindable : bool with get, set
Public Property IsNotDataBindable As Boolean
Значение свойства
true Значение , если свойство не поддерживает привязку данных; falseв противном случае . Значение по умолчанию — false.
Исключения
Метаданные уже применены к операции свойства зависимостей, поэтому метаданные запечатаны и свойства метаданных не могут быть заданы.
Комментарии
Обратите внимание, что это свойство метаданных задано true специально для свойств, которые не должны поддерживать привязку данных, несмотря на то, что свойства чтения и записи не поддерживаются. Ожидание заключается в том, что в большинстве случаев при объявлении свойства зависимостей требуется привязка данных, так как привязка данных является одним из ключевых сценариев, в которых полезно свойство зависимости. В отличие BindsTwoWayByDefaultот этого, это не просто изменяет значение по умолчанию, которое может быть изменено в определенной привязке. Задание этого свойства true в метаданных для метаданных свойства зависимостей отключает все привязки от применения их значений через выражения к этому свойству зависимостей.
Свойства зависимостей только для чтения не поддерживают привязку данных (так как они не имеют метода задания, который может применять измененные значения), но по-прежнему будет сообщать false о IsNotDataBindableних. Это связано с тем, что свойства, соответствующие FrameworkPropertyMetadataOptions значениям, будут сообщать о четности того, как метаданные были созданы, а не всегда сообщать о поведении конечного результата, которое может означать именование свойства. Чтобы определить, разрешает ли данное свойство зависимостей привязку данных, обычно следует проверить IsDataBindingAllowed .
IsDataBindingAllowed — это удобно для проверки как ReadOnly одной операции, так и IsNotDataBindable для получения ожидаемого результата.
Свойства производных PropertyMetadata классов обычно определяются в объектной модели как чтение и запись. Это позволяет настроить их после инициализации экземпляра. Однако после использования метаданных в рамках вызова Registerили AddOwnerOverrideMetadataсистемы свойств система свойств запечатывает этот экземпляр метаданных и свойства, которые передают особенности метаданных, теперь считаются неизменяемыми. Попытка задать это свойство после того, IsSealed как он находится true в этом экземпляре метаданных, вызовет исключение.
Использование текста XAML
Члены этого класса обычно не используются в XAML.