唯讀相依性屬性
更新：2007 年 11 月
本主題說明唯讀相依性屬性，包括現有的唯讀相依性屬性，以及建立自訂唯讀相依性屬性的案例和技巧。
這個主題包含下列章節。
- 必要條件
- 現有的唯讀相依性屬性
- 建立自訂唯讀相依性屬性
- 相關主題
必要條件
本主題假設您已了解實作相依性屬性的基本案例，以及中繼資料 (Metadata) 套用至自訂相依性屬性的方式。如需相關內容，請參閱自訂相依性屬性和相依性屬性中繼資料。
現有的唯讀相依性屬性
Windows Presentation Foundation (WPF) 架構中定義的某些相依性屬性是唯讀屬性。指定唯讀相依性屬性的原因通常是因為它們是判斷狀態時應該使用的屬性，但是該狀態受到許多因素影響，而就使用者介面設定的觀點而言，只將屬性設定為該狀態並不恰當。例如，IsMouseOver 屬性實際上只是從滑鼠輸入來判斷的表面狀態。嘗試透過規避實際的滑鼠輸入，改以程式設計方式設定這個值，都會產生無法預測且不一致的結果。
由於具有無法設定的特性，唯讀相依性屬性並不適用於相依性屬性通常可提供解決方案的許多案例 (也就是資料繫結 (Data Binding)、可直接設定樣式的值、驗證、動畫、繼承 (Inheritance))。雖然無法設定，但是唯讀相依性屬性仍然具有屬性系統中相依性屬性所支援的某些額外功能。其保留的最重要一項功能就是唯讀相依性屬性還是可以當做樣式中的屬性觸發程序 (Trigger)。您不能使用一般的 Common Language Runtime (CLR) 屬性來啟用觸發程序；此屬性必須是相依性屬性。前面提到的 IsMouseOver 屬性是最佳的案例範例；如果使用者將滑鼠放在控制項定義的某個區域時，控制項內複合項目的某些可見屬性 (例如背景、前景或類似屬性) 就會變更，這個屬性就可能相當適合用來定義這種控制項的樣式。唯讀相依性屬性中的變更也可以由屬性系統固有的失效處理序 (Process) 加以偵測及回報，而實際上這項功能也提供屬性觸發程序功能的內部支援。
建立自訂唯讀相依性屬性
請務必詳讀前一節，了解唯讀相依性不適用於許多一般相依性屬性案例的原因。不過，若有適當的案例，您還是可以建立自己的唯讀相依性屬性。
建立唯讀相依性屬性的程序大部分與自訂相依性屬性和 HOW TO：實作相依性屬性等主題說明的程序相同。主要的差異有三個：
註冊屬性時，請呼叫 RegisterReadOnly 方法，而非屬性註冊的一般 Register 方法。
實作 CLR「包裝函式」屬性時，請確定包裝函式也沒有 set 實作，如此您所公開的公用 (Public) 包裝函式才不會產生不一致的唯讀狀態。
唯讀註冊所傳回的屬性是 DependencyPropertyKey，而不是 DependencyProperty。您還是應該將這個欄位儲存為成員，但是通常不會將它設定該型別的公用成員。
您用來支援唯讀相依性屬性的任何私用 (Private) 欄位或值當然都可以使用您所決定的任何邏輯來撰寫。不過，設定屬性 (不論是初次設定或做為執行階段邏輯一部分) 最直接的方法是使用屬性系統的 API，而不是避開屬性系統，直接設定私用支援欄位。特別是有一個 SetValue 的簽章 (Signature) 可以接受型別 DependencyPropertyKey 的參數。您在應用程式邏輯內以程式設計方式設定這個值的方法和位置，將會影響您希望如何設定第一次註冊相依性屬性時所建立之 DependencyPropertyKey 的存取權。如果您完全在類別內處理這個邏輯，可以將它設定為私用；如果需要從組件的其他部分設定，則可將它設定為內部。 其中一種方法是在通知類別執行個體必須變更儲存屬性之相關事件的類別事件處理常式 (Event Handler) 內呼叫 SetValue。另一種方法則是在註冊過程中，使用成對的 PropertyChangedCallback 和 CoerceValueCallback 回呼 (Callback) 做為相依性屬性的中繼資料一部分，將這些屬性結合在一起。
因為 DependencyPropertyKey 是私用的，而且不會由屬性系統傳送到程式碼外部，所以相較於可讀寫的相依性屬性，唯讀相依性屬性的安全性設定確實較為完善。對於可讀寫的相依性屬性，識別欄位是明確或隱含公用的欄位，因此屬性可做廣泛的設定。如需詳細資訊，請參閱相依性屬性的安全性。