Поделиться через


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

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

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