FrameworkPropertyMetadata.IsNotDataBindable Propiedad

Definición

Obtiene o establece un valor que indica si la propiedad de dependencia admite enlace de datos.Gets or sets a value that indicates whether the dependency property supports data binding.

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

Valor de propiedad

true si la propiedad no admite enlace de datos; de lo contrario, false.true if the property does not support data binding; otherwise, false. De manera predeterminada, es false.The default is false.

Excepciones

Los metadatos ya se aplicaron a una operación de propiedad de dependencia, por lo que están sellados y no se pueden establecer sus propiedades.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

Comentarios

Tenga en true cuenta que esta propiedad de metadatos se establece específicamente para las propiedades que no deben admitir el enlace de datos, a pesar de ser propiedades de lectura y escritura.Note that this metadata property is set to true specifically for properties that should not support data binding, despite being read-write properties. La expectativa es que en la mayoría de los casos donde se declara una propiedad de dependencia, se desea el enlace de datos, ya que el enlace de datos es uno de los escenarios clave donde una propiedad de dependencia es útil.The expectation is that in most cases where a dependency property is declared, data binding is desired, because data binding is one of the key scenarios where a dependency property is useful. A diferencia BindsTwoWayByDefaultde, esto no cambia simplemente un valor predeterminado que se pueda cambiar más adelante en un enlace específico.Unlike BindsTwoWayByDefault, this does not merely change a default that can later be changed on a specific binding. Al establecer esta true propiedad en los metadatos de una propiedad de dependencia, se deshabilitarán todos los enlaces de la aplicación de sus valores a través de expresiones a esa propiedad de dependencia.Setting this property true in the metadata for a dependency property metadata will disable all bindings from applying their values through expressions to that dependency property.

Las propiedades de dependencia de solo lectura no admiten el enlace de datos (porque no tienen ningún establecedor que pueda aplicar valores modificados false ) IsNotDataBindable, pero seguirá informando para.Read-only dependency properties do not support data binding (because they have no setter that can apply changed values), but will still report false for IsNotDataBindable. Esto se debe a que las propiedades que FrameworkPropertyMetadataOptions corresponden a un valor informarán de la paridad con la forma en que se establecieron realmente los metadatos, en lugar de notificar siempre el comportamiento del resultado final que podría implicar la nomenclatura de la propiedad.This is because properties that correspond to a FrameworkPropertyMetadataOptions values will report parity with how the metadata was actually established, rather than always reporting the end result behavior that the naming of the property might imply. Para determinar si una propiedad de dependencia determinada permite el enlace de datos, normalmente IsDataBindingAllowed debería comprobar en su lugar.To determine whether a given dependency property permits data binding, you should usually check IsDataBindingAllowed instead. IsDataBindingAllowedes una comodidad para comprobar ReadOnly y IsNotDataBindable como una sola operación, lo que produce el resultado esperado.IsDataBindingAllowed is a convenience for checking both ReadOnly and IsNotDataBindable as a single operation, yielding the expected result.

Las propiedades de las clases PropertyMetadata derivadas de se definen normalmente en el modelo de objetos como de lectura y escritura.Properties on derived classes of PropertyMetadata are typically defined in the object model as read-write. Esto es para que se puedan ajustar después de la inicialización de la instancia.This is so they can be adjusted after initialization of the instance. Sin embargo, después de que se consuman los metadatos Registercomo AddOwnerparte de OverrideMetadatauna llamada a, o, el sistema de propiedades sellará esa instancia de metadatos y las propiedades que transmiten los detalles de los metadatos se consideran ahora inmutables.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. Si se IsSealed true intenta establecer esta propiedad después de en esta instancia de metadatos, se producirá una excepción.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Uso de texto XAMLXAML Text Usage

Los miembros de esta clase no se utilizan normalmente XAMLXAMLen.Members of this class are not typically used in XAMLXAML.

Se aplica a

Consulte también: