PropertyMetadata.CoerceValueCallback Propriedade

Definição

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Obtém ou define uma referência para uma implementação de CoerceValueCallback especificada nesses metadados.

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

Valor da propriedade

CoerceValueCallback

Uma referência de implantação de CoerceValueCallback.

Exceções

InvalidOperationException

Não é possível definir uma propriedade de metadados após sua aplicação a uma operação de propriedade de dependência.

Comentários

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 metadados de uma propriedade de dependência existente. 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 os metadados de substituição/adição especificarem um CoerceValueCallback. No entanto, a lógica de mesclagem padrão para um CoerceValueCallback é substituir a anterior.

CoerceValueCallback é definido no modelo de objeto como leitura/gravação. Isso pode CoerceValueCallback ser ajustado após a inicialização do PropertyMetadata próprio objeto. No entanto, depois que os metadados forem consumidos como parte de uma chamada para Register, AddOwnerou OverrideMetadata, o sistema de propriedades selará essa instância de metadados e as propriedades agora serão consideradas imutáveis. Tentar definir CoerceValueCallback uma vez IsSealed que está true nessa instância de metadados gerará uma exceção.