Déconseiller des types et des membres (C++/CX)

C++/CX prend en charge la dépréciation des types et membres Windows Runtime pour les producteurs et les consommateurs à l’aide de l’attribut Deprecated . Si vous utilisez une API qui a cet attribut, vous obtenez un message d’avertissement au moment de la compilation. Il indique que l’API est déconseillée et recommande également une autre API à utiliser. Dans vos propres types publics et methods, vous pouvez appliquer cet attribut et fournir votre propre message personnalisé.

Attention

L’attribut Deprecated est utilisé uniquement avec les types Windows Runtime. Pour les es et les membres C++ classstandard, utilisez [[deprecated]] (C++14 et versions ultérieures) ou __declspec(deprecated).

Exemple

L'exemple suivant montre comment déconseiller vos propres API publiques, par exemple dans un composant Windows Runtime. Le deuxième paramètre, de type Windows:Foundation::Metadata::DeprecationType , spécifie si l’API est déconseillée ou supprimée. Actuellement, seule la DeprecationType::Deprecated valeur est prise en charge. Le troisième paramètre de l’attribut spécifie l’attribut Windows::Foundation::Metadata::Platform auquel l’attribut s’applique.

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();
};

Cibles prises en charge

Le tableau suivant répertorie les constructs auxquels l’attribut Deprecated peut être appliqué :

class
enum
événement
method
property
struct field

delegate
enum field
interface
paramètre constructou
struct
Contrôle XAML

Voir aussi

Système de type (C++/CX)
Informations de référence sur le langage C++/CX
Informations de référence sur les espaces de noms