DependencyObject.SetValue(DependencyProperty, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает локальное значение свойства зависимостей для Объекта DependencyObject.
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;void SetValue(DependencyProperty const& dp, IInspectable const& value);public void SetValue(DependencyProperty dp, object value);function setValue(dp, value)Public Sub SetValue (dp As DependencyProperty, value As Object)Параметры
Идентификатор задаваемого свойства зависимостей.
- value
-
Object
Platform::Object
IInspectable
Новое локальное значение.
Комментарии
Если указанный тип значения не соответствует типу, объявленному для свойства зависимостей в том виде, в котором оно было первоначально зарегистрировано, возникает исключение.
Не все среда выполнения Windows свойства, используемые XAML, являются свойствами зависимостей. Идентификатор DependencyProperty должен существовать, и он должен быть доступен в качестве открытого свойства объекта-носителя, обычно объекта, который зарегистрировал свойство.
Для пользовательского кода приложения вызов SetValue обычно не требуется. Обычно свойство среда выполнения Windows зависимостей или пользовательское свойство зависимостей имеет обычное свойство, которое заключает его в оболочку, и вы можете просто задать значение свойства с помощью обычного использования пунктирной линией. Варианты, в которых можно по-прежнему использовать SetValue:
- Вы определяете пользовательское свойство зависимостей. Вы будете вызывать SetValue в рамках определения собственного метода доступа к набору свойств для обычного использования свойства. Дополнительную информацию см. в разделе Пользовательские свойства зависимостей.
- Вы определяете обратный вызов или находитесь в какой-либо другой область, где вам уже передается идентификатор DependencyProperty, и возможно, существует несколько свойств зависимостей, с которыми может потребоваться взаимодействовать в этом область. В таких случаях, вероятно, проще вызвать SetValue, передав идентификатор.