Dejar en desuso tipos y miembros (C++/CX)

C++/CX admite la desaprobación de los tipos y miembros de Windows Runtime para los productores y consumidores mediante el uso del atributo Deprecated. Si se consume una API que tiene este atributo, se recibirá un mensaje de advertencia en tiempo de compilación. Indica que la API está en desuso y también recomienda usar una API alternativa. Se puede aplicar este atributo en sus propios tipos y method públicos, así como proporcionar sus propios mensajes personalizados.

Precaución

El atributo Deprecated solo se usa con tipos de Windows Runtime. Para los miembros y class estándar de C++, use [[deprecated]] (C++14 y versiones posteriores) o __declspec(deprecated).

Ejemplo

En el ejemplo siguiente se muestra cómo marcar como desusadas tus propias API públicas, por ejemplo, en un componente de Windows en tiempo de ejecución. El segundo parámetro, de tipo Windows:Foundation::Metadata::DeprecationType, especifica si la API se marca como en desuso o se quita. Actualmente el único valor admitido es DeprecationType::Deprecated. El tercer parámetro del atributo especifica el Windows::Foundation::Metadata::Platform al que se aplica el atributo.

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 admitidos

En la tabla siguiente se enumeran las construcciones struct a las que se puede aplicar el atributo Deprecated:

class
enum
evento
method
property
struct field

delegate
enum field
interface
constructor struct parametrizado
struct
Control XAML

Consulte también

Sistema de tipos (C++/CX)
Referencia del lenguaje C++/CX
Referencia de espacios de nombres