Compartir a través de

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

  • Artículo

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. Puedes aplicar este atributo en tus propios tipos y métodos públicos, así como proporcionar tus propios mensajes personalizados.

Precaución

El atributo Deprecated solo se usa con tipos de Windows Runtime. En las clases y miembros de C++ estándar, usa [[deprecated]] (C++14 y posterior later) 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 a las que se puede aplicar el atributo Deprecated:

class
enum
event
method
property
struct field

delegate
enum field
interface
constructor parametrizado
struct
Control XAML

Consulte también

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