DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue Method

Определение

Задает локальное значение свойства зависимостей.Sets the local value of a dependency property.

Перегрузки

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);
public void SetValue (System.Windows.DependencyProperty dp, object value);
member this.SetValue : System.Windows.DependencyProperty * obj -> unit
Public Sub SetValue (dp As DependencyProperty, value As Object)

Параметры

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Идентификатор задаваемого свойства зависимостей.The identifier of the dependency property to set.

value
Object Object Object Object

Новое локальное значение.The new local value.

Исключения

Попытка изменить доступное только для чтения свойство зависимостей, или свойство в запечатанном DependencyObject.Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value не был корректным типом, зарегистрированным для свойства dp.value was not the correct type as registered for the dp property.

Комментарии

Если указанный тип не соответствует тип, объявленный для свойства зависимостей, как он изначально был зарегистрирован, создается исключение.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value Параметр всегда должен иметь вид соответствующего типа.The value parameter should always be provided as the appropriate type.

Условия возникновения исключений потенциально влияют ValidateValueCallback обратный вызов, который существует на идентификатор свойства зависимостей, задаваемого свойства зависимостей.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. В противном случае — значение, предоставленное возможно, произошла ошибка Общие условия проверки типов (например, передача строки, когда собственный тип — Double).Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);
public void SetValue (System.Windows.DependencyPropertyKey key, object value);
member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit
Public Sub SetValue (key As DependencyPropertyKey, value As Object)

Параметры

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Идентификатор DependencyPropertyKey задаваемого свойства.The DependencyPropertyKey identifier of the property to set.

value
Object Object Object Object

Новое локальное значение.The new local value.

Примеры

В следующем примере определяется свойство зависимостей только для чтения, наряду с public static readonly DependencyProperty , предоставляющий необходимые воздействие только для чтения свойство потребителей и метод доступа get для CLRCLR программы-оболочки.The following example defines a read-only dependency property, along with a public static readonly DependencyProperty that provides necessary read-only exposure to property consumers, and the get accessor for the CLRCLR wrapper.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Комментарии

Эта подпись обычно используется при задании значений для свойств зависимостей только для чтения, которые определяются пользовательские классы.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. Как правило SetValue вызывается только из типа, который зарегистрировал это свойство зависимости, который реализует внутренняя логика, которая предоставляет значения, указанного для свойства зависимостей.Generally, SetValue is called only from the type that registered that dependency property, which implements the internal logic that provides the determined value for the dependency property. Дополнительные сведения см. в разделе Свойства зависимостей "только для чтения".For more information, see Read-Only Dependency Properties.

Если указанный тип не соответствует тип, объявленный для свойства зависимостей, как он изначально был зарегистрирован, создается исключение.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value Параметр всегда должен иметь вид соответствующего типа.The value parameter should always be provided as the appropriate type. Условия возникновения исключений потенциально влияют ValidateValueCallback обратный вызов, который существует на идентификатор свойства зависимостей, задаваемого свойства зависимостей.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

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