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
, передав идентификатор.