DependencyObject.GetValue(DependencyProperty) 方法

定義

重要

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

編輯

從 DependencyObject傳回相依性屬性的目前有效值。

public:
 virtual Platform::Object ^ GetValue(DependencyProperty ^ dp) = GetValue;

IInspectable GetValue(DependencyProperty const& dp);

public object GetValue(DependencyProperty dp);

function getValue(dp)

Public Function GetValue (dp As DependencyProperty) As Object

要為其擷取值之屬性的 DependencyProperty 識別碼。

Object

Platform::Object

IInspectable

傳回目前有效值。

GetValue 會取得相依性屬性目前的有效值。目前的有效值是使用相依性屬性概觀的規則來決定。

如果您要使用屬性系統 API 來取得屬性值，則 GetValue 是您在大部分情況下想要的 API。但有時候您可能想要檢查其他值，以查看相依性屬性優先順序如何針對指定的屬性運作。如果是，您可以使用下列其中一個 API：

GetAnimationBaseValue 可取得目前可能以動畫顯示的值，但您想要知道動畫執行前的值。請注意，具有 HoldEnd 行為的動畫可能沒有這個相同的值。如需 HoldEnd 概念的詳細資訊，請參閱腳本動畫。
ReadLocalValue 可取得未套用樣式或範本或動畫的本機值。系結會計算為本機值，但根據您呼叫 ReadLocalValue時，作用中的系結內容可能尚無法使用，因此您不會取得與執行時間套用相同的值。如需相依性屬性優先順序和其他屬性系統公用程式 API 的詳細資訊，請參閱相依性屬性概觀。