DependencyObject.SetValue 方法

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

設定相依性屬性的本機值。

多載

SetValue(DependencyProperty, Object)	設定相依性屬性的本機值，其相依性屬性標識符所指定。
SetValue(DependencyPropertyKey, Object)	設定只讀相依性屬性的本機值，由相依性屬性 DependencyPropertyKey 標識碼所指定。

SetValue(DependencyProperty, Object)

設定相依性屬性的本機值，其相依性屬性標識符所指定。

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

要設定之相依性屬性的標識碼。

value

Object

新的本機值。

例外狀況

InvalidOperationException

嘗試修改唯讀相依性屬性，或密封 DependencyObject上的屬性。

ArgumentException

value 不是為 dp 屬性註冊的正確類型。

備註

如果提供的型別不符合原本註冊的相依性屬性所宣告的類型，則會擲回例外狀況。 value 參數應一律以適當的類型提供。

例外狀況可能會受到所設定相依性屬性之相依性屬性標識符上存在 ValidateValueCallback 回呼的影響。 否則，所提供的值可能會失敗的一般類型檢查條件（例如，在原生類型為 Double 時傳遞字串）。

SetValue(DependencyPropertyKey, Object)

設定只讀相依性屬性的本機值，由相依性屬性 DependencyPropertyKey 標識碼所指定。

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 識別碼。

value

Object

新的本機值。

範例

下列範例會定義唯讀相依性屬性，以及提供屬性取用者所需唯讀曝光的 public static readonlyDependencyProperty，以及 CLR 包裝函式的 get 存取子。

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

備註

當您設定自定義類別所定義的唯讀相依性屬性值時，通常會使用此簽章。 一般而言，SetValue 只會從註冊該相依性屬性的類型呼叫，這會實作內部邏輯，以提供相依性屬性的已決定值。 如需詳細資訊，請參閱 Read-Only 相依性屬性。

如果提供的型別不符合原本註冊的相依性屬性所宣告的類型，則會擲回例外狀況。 value 參數應一律以適當的類型提供。 例外狀況可能會受到所設定相依性屬性之相依性屬性標識符上存在 ValidateValueCallback 回呼的影響。