xtd::threading::cancellation_token_source Class Reference

Inheritance diagram for xtd::threading::cancellation_token_source:

Definition

Signals to a xtd::threading::cancellation_token that it should be canceled.

class core_export_ cancellation_token_source : public xtd::object

Inheritance

xtd::object → xtd::threading::cancellation_token_source

Header

#include <xtd/threading/cancellation_token_source>

Namespace

xtd::threading

Library

xtd.core

Remarks

The xtd uses a unified model for cooperative cancellation of asynchronous or long-running synchronous operations that involves two objects:

• A xtd::threading::cancellation_token_source object, which provides a cancellation token through its xtd::threading::cancellation_token_source::token property and sends a cancellation message by calling its xtd::threading::cancellation_token_source::cancel or xtd::threading::cancellation_token_sourcecancel_after method.
• A xtd::threading::cancellation_token object, which indicates whether cancellation is requested.

The general pattern for implementing the cooperative cancellation model is:

• Instantiate a xtd::threading::cancellation_token_source object, which manages and sends cancellation notification to the individual cancellation tokens.
• Pass the token returned by the xtd::threading::cancellation_token_source::token property to each task or thread that listens for cancellation.
• Call the xtd::threading::cancellation_token::is_cancellation_requested method from operations that receive the cancellation token. Provide a mechanism for each task or thread to respond to a cancellation request. Whether you choose to cancel an operation, and exactly how you do it, depends on your application logic.
• Call the xtd::threading::cancellation_token_source::cancel method to provide notification of cancellation. This sets the xtd::threading::cancellation_token.is_cancellation_requested property on every copy of the cancellation token to true.
• Call the xtd::threading::cancellation_token_source::close method when you are finished with the xtd::threading::cancellation_token_source object.

Public Constructors
	cancellation_token_source (int32 milliseconds_delay)
	cancellation_token_source (const time_span &delay)

Public Properties
bool	is_cancellation_requested () const noexcept
const cancellation_token &	token () const noexcept

Additional Inherited Members
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.
virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.
virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.
virtual type_object	get_type () const noexcept
	Gets the type of the current instance.
template<typename object_t >
xtd::uptr< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.
virtual xtd::string	to_string () const noexcept
	Returns a xtd::string that represents the current object.
Static Public Member Functions inherited from xtd::object
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.
template<typename object_a_t , typename object_b_t >
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/threading/cancellation_token_source.hpp