Udostępnij przez

Wycofane typy i składowe (C++/CX)

Język C++/CX obsługuje wycofanie typów środowisko wykonawcze systemu Windows i elementów członkowskich dla producentów i konsumentów przy użyciu atrybutu Deprecated . Jeśli używasz interfejsu API, który ma ten atrybut, zostanie wyświetlony komunikat ostrzegawczy w czasie kompilacji. Wskazuje, że interfejs API jest przestarzały, a także zaleca alternatywny interfejs API do użycia. We własnych typach publicznych i metodach można zastosować ten atrybut i podać własny niestandardowy komunikat.

Uwaga

Atrybut Deprecated jest używany tylko z typami środowisko wykonawcze systemu Windows. W przypadku standardowych klas i składowych języka C++ należy użyć ( [[deprecated]] C++14 i nowszych) lub __declspec(deprecated).

Przykład

W poniższym przykładzie pokazano, jak przestarzać własne publiczne interfejsy API — na przykład w składniku środowisko wykonawcze systemu Windows. Drugi parametr typu Windows::Foundation::Metadata::DeprecationType określa, czy interfejs API jest przestarzały, czy usuwany. Obecnie obsługiwana DeprecationType::Deprecated jest tylko wartość. Trzeci parametr w atrybucie określa Windows::Foundation::Metadata::Platform , do którego ma zastosowanie atrybut.

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

Obsługiwane obiekty docelowe

W poniższej tabeli wymieniono konstrukcje, do których Deprecated można zastosować atrybut:

class
enum
wydarzenie
method
property
struct field

delegate
enum field
interface
konstruktor sparametryzowany
struct
Kontrolka XAML

Zobacz też

System typów (C++/CX)
Dokumentacja języka C++/CX
Dokumentacja przestrzeni nazw

  • Last updated on