Condividi tramite

Deprecazione di tipi e membri (C++/CX)

  • Articolo

C++/CX supporta la deprecazione di tipi e membri di Windows Runtime per producer e consumer usando l'attributo Deprecated . Se si utilizza un'API con questo attributo, viene visualizzato un messaggio di avviso in fase di compilazione. Indica che l'API è deprecata e consiglia anche un'API alternativa da usare. Nei tuoi tipi e metodi pubblici puoi applicare questo attributo e fornire il tuo messaggio personalizzato.

Attenzione

L'attributo Deprecated è destinato all'uso solo con i tipi di Windows Runtime. Per classi e membri C++ standard, usare [[deprecated]] (C++14 e versioni successive) o __declspec(deprecated).

Esempio

Il seguente esempio mostra come deprecare le tue API pubbliche, ad esempio in un componente di Windows Runtime. Il secondo parametro di tipo Windows:Foundation::Metadata::DeprecationType specifica se l'API è deprecata o rimossa. Attualmente è supportato solo il DeprecationType::Deprecated valore . Il terzo parametro nell'attributo specifica l'oggetto Windows::Foundation::Metadata::Platform a cui si applica l'attributo.

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

Destinazioni supportate

Nella tabella seguente sono elencati i costrutti a cui può essere applicato l'attributo Deprecated :

class
enum
evento
method
property
struct field

delegate
enum field
interface
costruttore con parametri
struct
Controllo XAML

Vedi anche

Sistema dei tipi (C++/CX)
Riferimenti al linguaggio C++/CX
Informazioni di riferimento per gli spazi dei nomi