Ler em inglês

Compartilhar via


PropertyMetadata.CoerceValueCallback Propriedade

Definição

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

C#
public System.Windows.CoerceValueCallback CoerceValueCallback { get; set; }

Valor da propriedade

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

Exceções

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.

Aplica-se a

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10