Dela via


Utfasning av typer och medlemmar (C++/CX)

C++/CX stöder utfasning av Windows Runtime-typer och -medlemmar för producenter och konsumenter med hjälp av Deprecated attributet. Om du använder ett API som har det här attributet får du ett varningsmeddelande för kompileringstid. Det anger att API:et är inaktuellt och rekommenderar även ett alternativt API att använda. I dina egna offentliga typer och metoder kan du använda det här attributet och ange ett eget anpassat meddelande.

Försiktighet

Attributet Deprecated är endast till för användning med Windows Runtime-typer. För C++-standardklasser och medlemmar använder du [[deprecated]] (C++14 och senare) eller __declspec(deprecated).

Exempel

I följande exempel visas hur du föråldrar dina egna offentliga API:er — till exempel i en Windows Runtime-komponent. Den andra parametern av typen Windows::Foundation::Metadata::DeprecationType anger om API:et är inaktuellt eller borttaget. För närvarande stöds endast DeprecationType::Deprecated värdet. Den tredje parametern i attributet anger Windows::Foundation::Metadata::Platform som attributet gäller för.

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

Mål som stöds

I följande tabell visas de konstruktioner som Deprecated attributet kan tillämpas på:

class
enum
händelse
method
property
struct field

delegate
enum field
interface
parameteriserad konstruktor
struct
XAML-kontroll

Se även

Typsystem (C++/CX)
C++/CX-språkreferens
Namnområdesreferens