| IListener Interface |
The interface for objects that can listen to a stream of bytes and decode them into messages.
Namespace: VirtualRadar.Interface.Listener
Assembly: VirtualRadar.Interface (in VirtualRadar.Interface.dll) Version: 1.0.0.0 (1.0.0.0)
SyntaxThe IListener type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | BytesExtractor |
Gets the object that can extract the important bytes from the stream. Do not modify any properties on the extractor directly,
always use ChangeSource(IConnector, IMessageBytesExtractor, IRawMessageTranslator) to perform configuration changes.
|
| ConnectionStatus |
Gets a value indicating whether the listener is connected to the source of aircraft message data.
|
| Connector |
Gets the connector that is handling the connection for the listener. Do not modify any properties on the connection directly,
always use ChangeSource(IConnector, IMessageBytesExtractor, IRawMessageTranslator) to perform configuration changes.
|
| IgnoreBadMessages |
Gets or sets a value indicating whether exceptions thrown by the message translator cause a disconnection
and raise ExceptionCaught or whether they are ignored.
|
| IsSatcomFeed |
Gets or sets a value indicating that this is a satcom feed.
|
| RawMessageTranslator |
Gets the object that translates raw messages into Port30003 format messages. Do not modify any properties on the translator directly,
always use ChangeSource(IConnector, IMessageBytesExtractor, IRawMessageTranslator) to perform configuration changes.
|
| ReceiverId |
Gets or sets the identity of the receiver that is controlling this listener.
|
| ReceiverName |
Gets or sets the name of the receiver that is controlling this listener.
|
| Statistics |
Gets the statistics for the listener.
|
| TotalBadMessages |
Gets a count of the total number of messages that could not be translated.
|
| TotalMessages |
Gets a count of the total number of messages received by the object.
|
Methods| Name | Description | |
|---|---|---|
 | ChangeSource |
Changes the connector and/or message bytes extractor used by the listener.
|
| Connect |
Connects to the source of aircraft data. Incoming messages from the source will raise events on the listener.
|
| Disconnect |
Called implicitly by Dispose, disconnects from the source of aircraft message data.
|
| Dispose | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from IDisposable.) |
Events| Name | Description | |
|---|---|---|
 | ConnectionStateChanged |
Raised when the listener connects or disconnects. Note that exceptions raised during parsing of
messages will cause the object to automatically disconnect.
|
| ExceptionCaught |
Raised when an exception is caught on the background thread. The background thread should not
pass ThreadAbortException through this.
(Inherited from IBackgroundThreadExceptionCatcher.) |
| ModeSBytesReceived |
Raised when bytes representing a Mode-S message have been received. This may not be on the same thread that started
the listener - however all messages are guaranteed to be transmitted in the order in which they were received.
|
| ModeSMessageReceived |
Raised when a message has been received from the source of raw data. This may not be on the same thread that
started the listener - however all messages are guaranteed to be transmitted in the order in which they
were received.
|
| Port30003MessageReceived |
Raised when a message has been received from a source of Port30003 data. This may not be on the same thread
that started the listener - however all messages are guaranteed to be transmitted in the order in which they
were received.
|
| PositionReset |
Raised when a decoder that the listener is using to translate messages indicates that the previous position
reported for an aircraft was wrong and that its position has been reset.
|
| RawBytesReceived |
Raised when bytes have been received from the data source. This may not be on the same thread that started
the listener - however all messages are guaranteed to be transmitted in the order in which they were received.
|
| SourceChanged |
Raised when the listener is asked to change source of data. If the change in source causes a disconnect and
reconnect then this event is raised after the disconnect but before the reconnect.
|
See Also