Partilhar via


Tipos e membros preteridos (C++/CX)

O C++/CX oferece suporte à descontinuação de tipos e membros do Tempo de Execução do Windows 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. Ele indica que a API foi preterida e também recomenda uma API alternativa para usar. Em seus próprios tipos e métodos públicos, você pode aplicar esse atributo e fornecer sua própria mensagem personalizada.

Atenção

O Deprecated atributo é para uso somente com tipos do Tempo de Execução do Windows. Para classes e membros C++ padrão, use [[deprecated]] (C++14 e posterior) ou __declspec(deprecated).

Exemplo

O exemplo a seguir mostra como descontinuar as suas próprias APIs públicas —, por exemplo, num componente Windows Runtime. O segundo parâmetro, do tipo Windows::Foundation::Metadata::DeprecationType , especifica se a API está sendo preterida ou removida. Atualmente, apenas o DeprecationType::Deprecated valor é suportado. 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();
};

Alvos suportados

A tabela a seguir lista as construções às quais o Deprecated atributo pode ser aplicado:

class
enum
evento
method
property
struct field

delegate
enum field
interface
Construtor parametrizado
struct
Controle XAML

Ver também

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