DependencyObject.SetValue(DependencyProperty, Object) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

在 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)

要設定之相依性屬性的識別項。

新的本機值。

如果所提供的實值型別與原本註冊的相依性屬性所宣告的類型不符，則會擲回例外狀況。

並非所有WINDOWS 執行階段 XAML 所使用的屬性都是相依性屬性。 DependencyProperty識別碼必須存在，而且它必須是擁有物件的公用屬性，通常是註冊屬性的物件。

對於應用程式使用者程式碼，通常不需要呼叫 SetValue 。通常，Windows 執行階段相依性屬性或自訂相依性屬性具有包裝它的慣例屬性，而且您可以透過傳統虛線使用方式設定屬性值。您可能仍然使用 SetValue 的情況如下：

您正在定義自訂相依性屬性。您將呼叫 SetValue 作為定義傳統屬性使用方式之屬性集存取子的一部分。如需詳細資訊，請參閱自訂相依性屬性。
您正在定義回呼，或位於一些其他範圍中，其中您已傳遞 DependencyProperty 識別碼，而且您可能想要在該範圍內與多個相依性屬性互動。在這些情況下，呼叫的識別碼 SetValue 可能比較簡單。