Wycofane typy i składowe (C++/CX)Deprecating types and members (C++/CX)

W języku C++/CX jest możliwe wycofanie typów środowisko wykonawcze systemu Windows i członków dla producentów i konsumentów przy użyciu przestarzałego atrybutu.In C++/CX, deprecation of Windows Runtime types and members for producers and consumers by using the Deprecated attribute is supported. Jeśli korzystasz z interfejsu API, do którego zastosowano ten atrybut, otrzymasz komunikat ostrzegawczy czasu kompilacji, który wskazuje, że interfejs API jest przestarzały, a także zaleca alternatywny interfejs API do użycia.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. We własnych typach i metodach publicznych można zastosować ten atrybut i podać własny komunikat niestandardowy.In your own public types and methods, you can apply this attribute and supply your own custom message.

Przestroga

Przestarzały atrybut jest używany tylko z typami środowisko wykonawcze systemu Windows.The Deprecated attribute is for use only with Windows Runtime types. W przypadku standardowych klas i elementów członkowskich języka C++ Użyj __declspec (przestarzałe).For standard C++ classes and members, use __declspec(deprecated).

PrzykładExample

Poniższy przykład pokazuje, jak zastąpić własne publiczne interfejsy API — na przykład w składniku środowisko wykonawcze systemu Windows.The following example shows how to deprecate your own public APIs—for example, in a Windows Runtime component. Drugi parametr typu Windows: Foundation:: Metadata::D eprecationtype określa, czy interfejs API jest przestarzały czy usunięty.The second parameter, of type Windows:Foundation::Metadata::DeprecationType specifies whether the API is being deprecated or removed. Obecnie obsługiwana jest tylko wartość DeprecationType::D eprecated.Currently only the DeprecationType::Deprecated value is supported. Trzeci parametr w atrybucie określa Windows:: Foundation:: Metadata::P latform , do którego odnosi się ten atrybut.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();
};

Obsługiwane elementy doceloweSupported targets

W poniższej tabeli wymieniono konstrukcje, do których można zastosować przestarzały atrybut:The following table lists the constructs to which the Deprecated attribute may be applied:

określonejclass</span> Wierzdelegate</span> podstawoweenum</span> pole wyliczeniowe enum field
wydarzenevent</span> interfaceinterface

Methodmethod</span> sparametryzowany Konstruktor parameterized constructor
wartośćproperty</span> konstrukcjastruct</span> pole struktury struct field
Kontrolka XAMLXAML control

Zobacz teżSee also

System typówType System
Dokumentacja języka C++/CXC++/CX Language Reference
Dokumentacja przestrzeni nazwNamespaces Reference