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)

相依屬性的識別碼要設定。

新的在地價值。

若所提供的值型別與原始註冊時宣告的相依屬性類型不符，則會拋出例外。

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

對於應用程式的使用者程式碼，通常不需要呼叫 SetValue 。通常，Windows 執行階段的依賴性屬性或自訂的依賴性屬性會有一個傳統屬性來包裝它，你可以直接用點狀符號設定屬性值。你可能還會用 SetValue 到的情況有：

你是在定義一個自訂的相依屬性。您將在定義傳統物業使用時，作為 SetValue 定義您自己的物業集合存取器的一部分。如需詳細資訊，請參閱自訂相依性屬性。
你正在定義回調，或是在其他作用域，已經被傳達 DependencyProperty 識別碼，且可能存在多個相依屬性，你可能想在該範圍內互動。在這種情況下，通常會更簡單地呼叫 SetValue，傳遞識別碼。

此頁面對您有幫助嗎？