DependencyProperty.ReadOnly DependencyProperty.ReadOnly DependencyProperty.ReadOnly DependencyProperty.ReadOnly Property

定義

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

public:
 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")

注釈

読み取り専用の依存関係プロパティは、 RegisterReadOnly Registerメソッドではなくメソッドを呼び出すことによって、プロパティシステム内に登録されます。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.

読み取り専用の依存関係プロパティにDependencyPropertyKeyは、メタデータDependencyPropertyのオーバーライドや値の設定などのメタデータ操作を実行するために、識別子ではなく識別子を指定する必要があります。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. または識別子を公開するDependencyPropertyAPIAPIのをGetLocalValueEnumerator呼び出して識別子のコレクションを取得した場合ReadOnlyは、を呼び出すSetValue前にOverrideMetadata値を確認してください。入力パラメーターとしての依存関係プロパティ識別子。識別子が表す依存関係プロパティが読み取り専用でないことを確認します。If you obtained a collection of DependencyProperty identifiers through a call to GetLocalValueEnumerator or another APIAPI 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依存関係プロパティにある場合、その依存関係DependencyPropertyプロパティのDependencyPropertyKey識別子への参照を、メタデータから、または識別子から取得するためのプログラム的な方法はありません。は、読み取り専用の依存関係プロパティに対して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.

適用対象

こちらもご覧ください