DependencyObject.SetValue(DependencyProperty, Object) Метод

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

Задает локальное значение свойства зависимостей в 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идентификатор.

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

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