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 可能會比較簡單,傳遞識別碼。

適用於

另請參閱