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)參數
要設定之相依性屬性的識別項。
- value
-
Object
Platform::Object
IInspectable
新的本機值。
備註
如果提供的 實值 型別與原本註冊的相依性屬性所宣告的類型不符，則會擲回例外狀況。
並非所有WINDOWS 執行階段 XAML 所使用的屬性都是相依性屬性。 DependencyProperty識別碼必須存在，而且必須做為擁有物件的公用屬性，通常是註冊屬性的物件。
針對應用程式使用者程式碼，通常不需要呼叫 SetValue。 通常，Windows 執行階段相依性屬性或自訂相依性屬性具有包裝它的慣例屬性，而且您可以透過傳統的虛線用法來設定屬性值。 您可能仍然使用 SetValue 的案例如下：
- 您正在定義自訂相依性屬性。 您將呼叫 SetValue 作為定義傳統屬性使用方式之專屬屬性集存取子的一部分。 如需詳細資訊，請參閱自訂相依性屬性。
- 您正在定義回呼，或是在一些已傳遞 DependencyProperty 識別碼的其他範圍內，而且您可能想要在該範圍中與其互動的多個相依性屬性存在。 在這些情況下，呼叫 SetValue 可能會比較簡單，傳遞識別碼。