読み取り専用の依存関係プロパティ

2025-05-07

読み取り専用の依存関係プロパティを使用して、プロパティ値がコードの外部から設定されないようにすることができます。この記事では、既存の読み取り専用の依存関係プロパティと、カスタムの読み取り専用依存関係プロパティを作成するためのシナリオと手法について説明します。

[前提条件]

この記事では、依存関係プロパティの基本的な知識と、依存関係プロパティの概要読んだことを前提としています。この記事の例に従うには、拡張アプリケーションマークアップ言語 (XAML) に慣れている場合や、WPF アプリケーションを記述する方法を理解している場合に役立ちます。

読み取り専用の既存の依存プロパティ

通常、読み取り専用の依存関係プロパティは状態を報告します。 public アクセサーを使用して変更することはできません。たとえば、Windows Presentation Foundation (WPF) フレームワークは、 IsMouseOver プロパティを読み取り専用として実装します。その値はマウス入力によってのみ決定されるためです。他の入力 IsMouseOver 許可されている場合、その値がマウス入力と一致しなくなる可能性があります。 public アクセサーでは設定できませんが、既存の多くの読み取り専用依存関係プロパティには、複数の入力によって決定される値があります。

読み取り専用の依存関係プロパティの使用

依存関係プロパティが通常ソリューションを提供するいくつかのシナリオでは、読み取り専用の依存関係プロパティは適用されません。適用できないシナリオには、データバインディング、値へのスタイルの適用、検証、アニメーション、継承などがあります。ただし、読み取り専用の依存関係プロパティは、スタイルのプロパティトリガーとして使用できます。たとえば、IsMouseOver は、マウスが乗ったときに、コントロールの背景、前景、またはその他の表示されるプロパティを変更するために一般的に使用されます。 WPF プロパティシステムは、読み取り専用の依存関係プロパティの変更を検出して報告するため、プロパティトリガー機能をサポートします。読み取り専用の依存関係プロパティは、コレクションオブジェクト自体ではなく、コレクション要素のみを書き込み可能にする必要があるコレクション型の依存関係プロパティを実装する場合にも便利です。詳細については、「コレクション型の依存関係プロパティ」を参照してください。

注

スタイルのプロパティトリガーとして使用できるのは、通常の共通言語ランタイムプロパティではなく、依存関係プロパティのみです。

カスタム読み取り専用依存関係プロパティの作成

読み取り専用の依存関係プロパティを作成する前に、該当しないシナリオを確認してください。

読み取り専用の依存関係プロパティを作成するプロセスは、読み取り/書き込み依存関係プロパティの作成と似ていますが、次のような違いがあります。

読み取り専用プロパティを登録するときは、RegisterReadOnlyではなくRegisterを呼び出します。
CLR プロパティラッパーを実装するときは、パブリック set アクセサーがないことを確認します。
RegisterReadOnlyは、DependencyPropertyKeyではなくDependencyPropertyを返します。 DependencyPropertyKeyを非パブリッククラスメンバーに格納します。

選択したロジックを使用して、読み取り専用の依存関係プロパティの値を決定できます。プロパティ値を初期またはランタイムロジックの一部として設定するには、SetValue型のパラメーターを受け取るDependencyPropertyKeyのオーバーロードを使用することをお勧めします。プロパティシステムを回避し、バッキングフィールドを直接設定するには、 SetValue を使用することをお勧めします。

アプリケーション内の読み取り専用依存関係プロパティの値を設定する方法と場所は、 DependencyPropertyKeyを格納するクラスメンバーに割り当てるアクセスレベルに影響します。依存関係プロパティを登録するクラス内からのみプロパティ値を設定する場合は、 private アクセス修飾子を使用できます。依存関係プロパティの値が相互に影響するシナリオでは、ペアの PropertyChangedCallback コールバックと CoerceValueCallback コールバックを使用して値の変更をトリガーできます。詳細については、「依存関係プロパティのメタデータ」を参照してください。

読み取り専用の依存関係プロパティの値を登録するクラスの外部から変更する必要がある場合は、internalにDependencyPropertyKeyアクセス修飾子を使用できます。たとえば、同じアセンブリ内のイベントハンドラーから SetValue を呼び出す場合があります。次の例では、 RegisterReadOnly を呼び出して読み取り専用の依存関係プロパティ FishCountを作成する Aquarium クラスを定義します。 DependencyPropertyKeyは、同じアセンブリ内のコードが読み取り専用の依存関係プロパティ値を変更できるように、internal static readonly フィールドに割り当てられます。

public class Aquarium : DependencyObject
{
    // Register a dependency property with the specified property name,
    // property type, owner type, and property metadata.
    // Assign DependencyPropertyKey to a nonpublic field.
    internal static readonly DependencyPropertyKey FishCountPropertyKey =
        DependencyProperty.RegisterReadOnly(
          name: "FishCount",
          propertyType: typeof(int),
          ownerType: typeof(Aquarium),
          typeMetadata: new FrameworkPropertyMetadata());

    // Declare a public get accessor.
    public int FishCount =>
        (int)GetValue(FishCountPropertyKey.DependencyProperty);
}

Public Class Aquarium
    Inherits DependencyObject

    ' Register a dependency property with the specified property name,
    ' property type, owner type, And property metadata.
    ' Assign DependencyPropertyKey to a nonpublic field.
    Friend Shared ReadOnly FishCountPropertyKey As DependencyPropertyKey =
        DependencyProperty.RegisterReadOnly(
            name:="FishCount",
            propertyType:=GetType(Integer),
            ownerType:=GetType(Aquarium),
            typeMetadata:=New FrameworkPropertyMetadata())

    ' Declare a public get accessor.
    Public ReadOnly Property FishCount As Integer
        Get
            Return GetValue(FishCountPropertyKey.DependencyProperty)
        End Get
    End Property

End Class

WPF プロパティシステムはコードの外部に DependencyPropertyKey を伝達しないため、読み取り専用の依存関係プロパティは、読み取り/書き込み依存関係プロパティよりも書き込みセキュリティが優れています。 DependencyPropertyKeyへの参照を持つユーザーに書き込みアクセスを制限する場合は、読み取り専用の依存関係プロパティを使用します。

これに対し、読み取り/書き込み依存関係プロパティの依存関係プロパティ識別子には、割り当てるアクセス修飾子に関係なく、プロパティシステムからアクセスできます。詳細については、「依存関係プロパティのセキュリティ」を参照してください。

次の方法で共有

読み取り専用の依存関係プロパティ

[前提条件]

読み取り専用の既存の依存プロパティ

読み取り専用の依存関係プロパティの使用

カスタム読み取り専用依存関係プロパティの作成

こちらも参照ください

その他のリソース