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
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios