Dejar en desuso tipos y miembros (C++/CX)Deprecating types and members (C++/CX)

En C++/CX, se admite la degradación de los tipos de Windows Runtime y los miembros de los productores y consumidores mediante el atributo deprecated .In C++/CX, deprecation of Windows Runtime types and members for producers and consumers by using the Deprecated attribute is supported. Si utilizas una API a la que se ha aplicado este atributo, obtienes un mensaje de advertencia en tiempo de compilación que indica que la API está desusada y que te recomienda una API alternativa.If you consume an API to which this attribute has been applied, you get a compile-time warning message that indicates that the API is deprecated and also recommends an alternative API to use. Puedes aplicar este atributo en tus propios tipos y métodos públicos, así como proporcionar tus propios mensajes personalizados.In your own public types and methods, you can apply this attribute and supply your own custom message.

Precaución

El atributo deprecated solo se utiliza con tipos de Windows Runtime.The Deprecated attribute is for use only with Windows Runtime types. En las clases y miembros de C++ estándar, usa __declspec(deprecated).For standard C++ classes and members, use __declspec(deprecated).

EjemploExample

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.The following example shows how to deprecate your own public APIs—for example, in a Windows Runtime component. El segundo parámetro, de tipo Windows:Foundation::Metadata::DeprecationType , especifica si la API se está marcando como desusada o se está quitando.The second parameter, of type Windows:Foundation::Metadata::DeprecationType specifies whether the API is being deprecated or removed. Actualmente, solo se admite el valor DeprecationType::Deprecated.Currently only the DeprecationType::Deprecated value is supported. El tercer parámetro del atributo especifica el objeto Windows::Foundation::Metadata::Platform al que se aplica el atributo.The third parameter in the attribute specifies the Windows::Foundation::Metadata::Platform to which the attribute applies.


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 admitidosSupported targets

En la tabla siguiente se enumeran las construcciones a las que se puede aplicar el atributo Deprecated:The following table lists the constructs to which the Deprecated attribute may be applied:

lasclass</span> Delegadodelegate</span> enumeraciónenum</span> campo de enumeración enum field
cesoevent</span> interfazinterface

formamethod</span> constructor con parámetros parameterized constructor
propertyproperty
Destructorstruct</span> campo struct struct field
Control XAMLXAML control

Consulte tambiénSee also

Sistema de tiposType System
Referencia del lenguaje C++/CXC++/CX Language Reference
Referencia de espacios de nombresNamespaces Reference