共用方式為


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 可能比較簡單。

適用於

另請參閱