FrameworkPropertyMetadata.Inherits FrameworkPropertyMetadata.Inherits FrameworkPropertyMetadata.Inherits FrameworkPropertyMetadata.Inherits Property

Определение

Получает или задает значение, которое указывает, наследуется ли значение свойства зависимостей.Gets or sets a value that indicates whether the value of the dependency property is inheritable.

public:
 property bool Inherits { bool get(); void set(bool value); };
public bool Inherits { get; set; }
member this.Inherits : bool with get, set
Public Property Inherits As Boolean

Значение свойства

Значение true, если значение свойства может быть унаследовано; в противном случае — значение false.true if the property value is inheritable; otherwise, false. Значение по умолчанию — false.The default is false.

Исключения

Метаданные уже применены к операции свойства зависимостей. Поэтому метаданные запечатаны, а их свойства нельзя задать.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

Примеры

Следующий пример получает метаданные по умолчанию из различных зависимостей поля свойств, значения различных FrameworkPropertyMetadata свойства и использует эти сведения для заполнения таблицы и реализации «обозревателя метаданных».The following example obtains the default metadata from various dependency property fields, queries the value of various FrameworkPropertyMetadata properties on it, and uses the information to populate a table to implement a "metadata browser".

pm = dp.GetMetadata(dp.OwnerType);
pm = dp.GetMetadata(dp.OwnerType)
FrameworkPropertyMetadata fpm = pm as FrameworkPropertyMetadata;
if (fpm!=null) {
    AffectsArrange.Text = (fpm.AffectsArrange) ? "Yes" : "No";
    AffectsMeasure.Text = (fpm.AffectsMeasure) ? "Yes" : "No";
    AffectsRender.Text = (fpm.AffectsRender) ? "Yes" : "No";
    Inherits.Text = (fpm.Inherits) ? "Yes" : "No";
    IsDataBindingAllowed.Text = (fpm.IsDataBindingAllowed) ? "Yes" : "No";
    BindsTwoWayByDefault.Text = (fpm.BindsTwoWayByDefault) ? "Yes" : "No";
}         
Dim fpm As FrameworkPropertyMetadata = TryCast(pm, FrameworkPropertyMetadata)
If fpm IsNot Nothing Then
	AffectsArrange.Text = If((fpm.AffectsArrange), "Yes", "No")
	AffectsMeasure.Text = If((fpm.AffectsMeasure), "Yes", "No")
	AffectsRender.Text = If((fpm.AffectsRender), "Yes", "No")
              [Inherits].Text = If((fpm.Inherits), "Yes", "No")
	IsDataBindingAllowed.Text = If((fpm.IsDataBindingAllowed), "Yes", "No")
	BindsTwoWayByDefault.Text = If((fpm.BindsTwoWayByDefault), "Yes", "No")

Комментарии

Наследование значения свойства — это функция WPFWPF системой свойств на уровне платформы WPF, при котором некоторые свойства зависимостей можно локально задать в элементе близка к корню XAMLXAML элемент дерева и затем их значений, наследуются все элементы в логическом дереве дочерних элементов, которые также обладают этим свойством.Property value inheritance is a feature of the WPFWPF property system at the WPF framework level, whereby certain dependency properties can be locally set on an element at or near the root of a XAMLXAML element tree and then have their value inherited by all elements within the logical tree of child elements that also possess that property. Наследование значения свойства не включена по умолчанию, и его подключение имеет некоторые последствия для производительности.Property value inheritance is not enabled by default, and enabling it does have some performance implications. Подробнее см. в разделе Наследование значения свойства.For details, see Property Value Inheritance.

Примечание

Несмотря на то, что наследование значения свойства могут быть выполнены для неприсоединенных свойств зависимостей, поведение наследования для таких свойств через определенные разделениях в дереве среды выполнения не определено.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain object-object divisions in the runtime tree is undefined. Всегда используйте RegisterAttached для регистрации вы зададите свойства Inherits в метаданных.Always use RegisterAttached to register properties where you specify Inherits in the metadata.

Свойства классов, производных от PropertyMetadata обычно определяются в модели объектов чтения и записи.Properties on derived classes of PropertyMetadata are typically defined in the object model as read-write. Это, поэтому их можно изменить после инициализации экземпляра.This is so they can be adjusted after initialization of the instance. Однако после метаданных используется как часть вызова Register, AddOwner, или OverrideMetadata, система свойств будет запечатать этот экземпляр метаданных и свойств, которые передают особенности метаданные теперь считаются неизменяемыми.However, after the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and properties that convey the specifics of the metadata are now considered immutable. Попытка задать это свойство после IsSealed является true на эти метаданные экземпляра будет выдано исключение.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Использование текста XAMLXAML Text Usage

Члены этого класса обычно не используются в XAMLXAML.Members of this class are not typically used in XAMLXAML.

Применяется к

Дополнительно