PropertyMetadata.CoerceValueCallback Property

Definition

Obtém ou define uma referência para uma implementação de CoerceValueCallback especificada nesses metadados.Gets or sets a reference to a CoerceValueCallback implementation specified in this metadata.

public:
 property System::Windows::CoerceValueCallback ^ CoerceValueCallback { System::Windows::CoerceValueCallback ^ get(); void set(System::Windows::CoerceValueCallback ^ value); };
public System.Windows.CoerceValueCallback CoerceValueCallback { get; set; }
member this.CoerceValueCallback : System.Windows.CoerceValueCallback with get, set
Public Property CoerceValueCallback As CoerceValueCallback

Property Value

CoerceValueCallback

Uma referência de implantação de CoerceValueCallback.A CoerceValueCallback implementation reference.

Exceptions

Não é possível definir uma propriedade de metadados após sua aplicação a uma operação de propriedade de dependência.Cannot set a metadata property once it is applied to a dependency property operation.

Remarks

Os retornos de chamada nos metadados de propriedade normalmente não são membros públicos no tipo recipiente, portanto, o valor dessa propriedade não é importante para a maioria dos cenários que apenas consomem os metadados de uma propriedade de dependência existente.The callbacks in property metadata are not typically public members on the containing type, so the value of this property is not important for most scenarios that just consume an existing dependency property's metadata. Um motivo pelo qual essa propriedade é exposta é para que as subclasses de metadados possam executar a lógica de mesclagem desejada se os metadados base e a substituição/adição de metadados especificarem um CoerceValueCallback.One reason this property is exposed is so that metadata subclasses can perform their desired merge logic if both base metadata and overriding/adding metadata specify a CoerceValueCallback. No entanto, a lógica de mesclagem padrão para uma CoerceValueCallback é substituir a anterior.However, the default merge logic for a CoerceValueCallback is to replace the previous one.

CoerceValueCallback é definido no modelo de objeto como leitura-gravação.CoerceValueCallback is defined in the object model as read-write. Isso é para que CoerceValueCallback possa ser ajustado após a inicialização do próprio objeto PropertyMetadata.This is so CoerceValueCallback can be adjusted after initialization of the PropertyMetadata object itself. No entanto, uma vez que os metadados são consumidos como parte de uma chamada para Register, AddOwnerou OverrideMetadata, o sistema de propriedades lacrará essa instância de metadados e as propriedades agora serão consideradas imutáveis.However, once the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and the properties are now considered immutable. A tentativa de definir CoerceValueCallback uma vez IsSealed está true nessa instância de metadados gerará uma exceção.Attempting to set CoerceValueCallback once IsSealed is true on this metadata instance will raise an exception.

Applies to