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)

Параметры

dp
DependencyProperty

Идентификатор задаваемого свойства зависимостей.

value
Object

Platform::Object

IInspectable

Новое локальное значение.

Комментарии

Если предоставленный тип значения не соответствует типу, объявленному для свойства зависимостей, так как он был первоначально зарегистрирован, создается исключение.

Не все среда выполнения Windows свойства, используемые XAML, являются свойствами зависимостей. Идентификатор DependencyProperty должен существовать, и он должен быть доступен в качестве открытого свойства объекта-владеющего, как правило, объекта, который зарегистрировал свойство.

Для пользовательского кода приложения вызов SetValue обычно не требуется. Как правило, свойство среда выполнения Windows зависимостей или пользовательское свойство зависимостей имеет обычное свойство, которое заключает его в оболочку, и вы можете просто задать значение свойства с помощью обычного использования с точками. Варианты, в которых вы по-прежнему можете использовать SetValue :

  • Вы определяете пользовательское свойство зависимостей. Вы будете вызывать SetValue в рамках определения собственного метода доступа к набору свойств для обычного использования свойства. Дополнительную информацию см. в разделе Пользовательские свойства зависимостей.
  • Вы определяете обратный вызов или находитесь в некоторых других область, где вам уже передается идентификатор DependencyProperty, и возможно, существует несколько свойств зависимостей, с которыми может потребоваться взаимодействовать в этом область. В таких случаях, вероятно, проще вызвать SetValue, передав идентификатор.

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

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