RTI Connext C# API Version 7.2.0
Rti.Dds.Core.Entity Class Referenceabstract

Abstract base class for all the DDS objects that support QoS policies, status events, and a status condition. More...

Inheritance diagram for Rti.Dds.Core.Entity:
Rti.Dds.Domain.DomainParticipant Rti.Dds.Publication.AnyDataWriter Rti.Dds.Publication.Publisher Rti.Dds.Subscription.AnyDataReader Rti.Dds.Subscription.Subscriber Rti.Dds.Topics.Topic< T > Rti.Dds.Publication.DataWriter< T > Rti.Dds.Subscription.DataReader< T >

Public Member Functions

void Enable ()
 Enables this Entity (by default entities are automatically enabled after creation) More...
 
abstract void ResetEvents (StatusMask eventsToRemove=StatusMask.All)
 Stop notifying of events and remove their event handlers. The actual events are defined in each derived entity class. More...
 
EntityLock Lock ()
 Locks the Entity using its internal lock. More...
 
void Dispose ()
 Releases the resources used by this Entity and disposes its contained entities as well (if any). More...
 

Properties

InstanceHandle InstanceHandle [get]
 Gets the InstanceHandle that identifies this Entity More...
 
StatusMask StatusChanges [get]
 Retrieves the list of communication statuses in this Entity that are triggered. More...
 
StatusCondition StatusCondition [get]
 Gets the StatusCondition associated with this Entity. More...
 
bool Enabled [get]
 Indicates whether this Entity is enabled. More...
 
bool Disposed [get]
 Indicates whether this Entity has already been disposed. More...
 

Detailed Description

Abstract base class for all the DDS objects that support QoS policies, status events, and a status condition.

The full documentation is available in the C API: DDSEntity

Member Function Documentation

◆ Enable()

void Rti.Dds.Core.Entity.Enable ( )

Enables this Entity (by default entities are automatically enabled after creation)

The full documentation is available in the C API: DDSEntity_enable

◆ ResetEvents()

abstract void Rti.Dds.Core.Entity.ResetEvents ( StatusMask  eventsToRemove = StatusMask.All)
pure virtual

Stop notifying of events and remove their event handlers. The actual events are defined in each derived entity class.

Parameters
eventsToRemoveSelects which events will stop receiving notifications. StatusMask.All (the default) removes all event handlers.

Implemented in Rti.Dds.Domain.DomainParticipant, Rti.Dds.Publication.AnyDataWriter, Rti.Dds.Publication.Publisher, Rti.Dds.Subscription.AnyDataReader, Rti.Dds.Subscription.Subscriber, and Rti.Dds.Topics.Topic< T >.

◆ Lock()

EntityLock Rti.Dds.Core.Entity.Lock ( )

Locks the Entity using its internal lock.

The full documentation is available in the C API: DDSEntity_lock

◆ Dispose()

void Rti.Dds.Core.Entity.Dispose ( )
inline

Releases the resources used by this Entity and disposes its contained entities as well (if any).

Exceptions
PreconditionNotMetExceptionWhen the entity cannot be disposed. For example, a topic cannot be disposed if a DataReader or a DataWriter is using it; a DataReader can't be disposed when a LoanedSamples returned by the DataReader is still in use.

Property Documentation

◆ InstanceHandle

InstanceHandle Rti.Dds.Core.Entity.InstanceHandle
get

Gets the InstanceHandle that identifies this Entity

The full documentation is available in the C API: DDSEntity_get_instance_handle

◆ StatusChanges

StatusMask Rti.Dds.Core.Entity.StatusChanges
get

Retrieves the list of communication statuses in this Entity that are triggered.

The full documentation is available in the C API: DDSEntity_get_status_changes

◆ StatusCondition

StatusCondition Rti.Dds.Core.Entity.StatusCondition
get

Gets the StatusCondition associated with this Entity.

The full documentation is available in the C API: DDSEntity_get_statuscondition

◆ Enabled

bool Rti.Dds.Core.Entity.Enabled
get

Indicates whether this Entity is enabled.

◆ Disposed

bool Rti.Dds.Core.Entity.Disposed
get

Indicates whether this Entity has already been disposed.