DependencyProperty.ReadOnly プロパティ


この DependencyProperty インスタンスによって識別される依存関係プロパティが読み取り専用の依存関係プロパティかどうかを示す値を取得します。Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

 property bool ReadOnly { bool get(); };
public bool ReadOnly { get; }
member this.ReadOnly : bool
Public ReadOnly Property ReadOnly As Boolean


依存関係プロパティが読み取り専用の場合は true。それ以外の場合は falsetrue if the dependency property is read-only; otherwise, false.

次の例では、さまざまな依存関係プロパティのフィールドから既定のメタデータと依存関係プロパティの識別子プロパティを取得し、情報を使用してテーブルに "メタデータブラウザー" を実装します。The following example obtains the default metadata and the dependency property identifier properties from various dependency property fields, and uses the information to populate a table to implement a "metadata browser".

pm = dp.GetMetadata(dp.OwnerType);
MetadataClass.Text = pm.GetType().Name;
TypeofPropertyValue.Text = dp.PropertyType.Name;
DefaultPropertyValue.Text = (pm.DefaultValue!=null) ? pm.DefaultValue.ToString() : "null";
HasCoerceValue.Text = (pm.CoerceValueCallback == null) ? "No" : pm.CoerceValueCallback.Method.Name;
HasPropertyChanged.Text = (pm.PropertyChangedCallback == null) ? "No" : pm.PropertyChangedCallback.Method.Name;
ReadOnly.Text = (dp.ReadOnly) ? "Yes" : "No";
pm = dp.GetMetadata(dp.OwnerType)
MetadataClass.Text = pm.GetType().Name
TypeofPropertyValue.Text = dp.PropertyType.Name
DefaultPropertyValue.Text = If((pm.DefaultValue IsNot Nothing), pm.DefaultValue.ToString(), "null")
HasCoerceValue.Text = If((pm.CoerceValueCallback Is Nothing), "No", pm.CoerceValueCallback.Method.Name)
HasPropertyChanged.Text = If((pm.PropertyChangedCallback Is Nothing), "No", pm.PropertyChangedCallback.Method.Name)
    [ReadOnly].Text = If((dp.ReadOnly), "Yes", "No")


読み取り専用の依存関係プロパティは、Register メソッドではなく、RegisterReadOnly メソッドを呼び出すことによって、プロパティシステム内に登録されます。Read-only dependency properties are registered within the property system by calling the RegisterReadOnly method as opposed to the Register method. 添付プロパティは、読み取り専用として登録することもできます。「RegisterAttachedReadOnly」を参照してください。Attached properties can also be registered as read-only; see RegisterAttachedReadOnly.

読み取り専用の依存関係プロパティには、メタデータのオーバーライドや値の設定などのメタデータ操作を実行するために、DependencyProperty 識別子ではなく DependencyPropertyKey 識別子が必要です。Read-only dependency properties require a DependencyPropertyKey identifier rather than a DependencyProperty identifier to perform metadata operations such as overriding the metadata or setting the value. GetLocalValueEnumerator または識別子を公開する別の API を呼び出すことによって DependencyProperty 識別子のコレクションを取得した場合は、SetValue を呼び出す前に ReadOnly 値を確認するか、入力パラメーターとしてその依存関係プロパティ識別子を使用 OverrideMetadata します。識別子が表す依存関係プロパティが読み取り専用でないことを確認します。If you obtained a collection of DependencyProperty identifiers through a call to GetLocalValueEnumerator or another API that exposes identifiers, check the ReadOnly value before attempting to call SetValue or OverrideMetadata using that dependency property identifier as an input parameter, to verify that the dependency property that the identifier represents is not read-only. ReadOnly の値が依存関係プロパティで true 場合、その依存関係プロパティの DependencyPropertyKey 識別子への参照を、メタデータまたは DependencyProperty 識別子から取得するためのプログラムによる方法はありません。読み取り専用の依存関係プロパティに対して SetValue(DependencyPropertyKey, Object) を呼び出すためには、識別子を静的フィールドとして使用できる必要があります。If the value of ReadOnly is true on a dependency property, there is no programmatic way to obtain a reference to the DependencyPropertyKey identifier of that dependency property, from the metadata or from the DependencyProperty identifier; the identifier must be available as a static field in order to call SetValue(DependencyPropertyKey, Object) against a read-only dependency property.

カスタム依存関係プロパティを作成し、読み取り専用として登録する場合は、CLRCLR ラッパープロパティの get アクセサーのみを定義する必要があります。When you create a custom dependency property, and register it as read-only, you should define only a get accessor for the CLRCLR wrapper property. それ以外の場合は、バッキング依存関係プロパティへのアクセスと比較して、クラスにプロパティラッパーの混乱したオブジェクトモデルが含まれます。Otherwise, your class will have a confusing object model for the property wrapper as compared to the access to the backing dependency property. 詳細については、「カスタム依存関係プロパティ」または「読み取り専用の依存関係プロパティ」を参照してください。For details, see Custom Dependency Properties or Read-Only Dependency Properties.