Reprovando tipos e membros (C++/CX)

Em C++/CX, há suporte para a substituição de tipos e membros do Windows Runtime para produtores e consumidores usando o atributo Deprecated. Se você consumir uma API que tenha esse atributo, receberá uma mensagem de aviso em tempo de compilação. Indica que a API foi preterida e também recomenda uma API alternativa a ser usada. Em seus tipos e method públicos, você pode aplicar esse atributo e fornecer sua própria mensagem personalizada.

Cuidado

O atributo Deprecated deve ser usado apenas com os tipos do Windows Runtime. Para membros classes e C++ padrão, use [[deprecated]] (C++14 e posterior) ou __declspec(deprecated).

Exemplo

O exemplo a seguir mostra como substituir suas próprias APIs públicas – por exemplo, em um componente do Windows Runtime. O segundo parâmetro, do tipo Windows:Foundation::Metadata::DeprecationType especifica se a API está sendo substituída ou removida. Atualmente, somente o valor DeprecationType::Deprecated tem suporte. O terceiro parâmetro no atributo especifica a Windows::Foundation::Metadata::Platform à qual o atributo se aplica.

namespace wfm = Windows::Foundation::Metadata;

public ref class Bicycle sealed
{

public:
    property double Speed;

    [wfm::Deprecated("Use the Speed property to compute the angular speed of the wheel", wfm::DeprecationType::Deprecate, 0x0)]
    double ComputeAngularVelocity();
};

Destinos compatíveis

A tabela a seguir lista as constructs às quais o atributo Deprecated pode ser aplicado:

class
enum
event
method
property
struct field

delegate
enum field
interface
construct parametrizado ou
struct
Controle XAML

Confira também

Sistema de tipos (C++/CX)
Referência da linguagem C++/CX
Referência de namespaces