Data Provider for .NET Developer's Guide
ContentsOpens a new window
Opens a new window
Page 117 of 172

OracleAQMessageAvailableEventArgs Class

The OracleAQMessageAvailableEventArgs class provides event data for the OracleAQQueue.MessageAvailable event.

Class Inheritance

System.Object

  System.EventArgs

    Oracle.DataAccess.Client.OracleAQMessageAvailableEventArgs

Declaration

// C#
public sealed class OracleAQMessageAvailableEventArgs

Requirements

Provider ODP.NET, Unmanaged Driver
Assembly Oracle.DataAccess.dll
Namespace Oracle.DataAccess.Client
.NET Framework 3.5, 4.0, 4.5

Thread Safety

All public static methods are thread-safe, although instance methods do not guarantee thread safety.

Remarks

This class cannot be inherited.

For detailed information on all the inherited properties and methods, please read the documentation provided by Microsoft's .NET Documentation.

OracleAQMessageAvailableEventArgs Members

OracleAQMessageAvailableEventArgs members are listed in the following tables.

OracleAQMessageAvailableEventArgs Constructor

OracleAQMessageAvailableEventArgs properties are listed in Table 12-17Opens a new window

Table 12-17 OracleAQMessageAvailableEventArgs Constructor

Property Description

OracleAQMessageAvailableEventArgs ConstructorOpens a new window

Instantiates a new instance of the OracleAQMessageAvailableEventArgs class.


OracleAQMessageAvailableEventArgs Properties

OracleAQMessageAvailableEventArgs properties are listed in Table 12-18Opens a new window.

Table 12-18 OracleAQMessageAvailableEventArgs Properties

Property Description

AvailableMessagesOpens a new window

Specifies the number of messages that raised this notification.

ConsumerNameOpens a new window

Provides the name of the consumer for which the message is available for dequeuing.

CorrelationOpens a new window

Provides the name of the consumer for which the message is available for dequeuing.

DelayOpens a new window

Specifies the duration, in seconds, after which an enqueued message is available for dequeuing.

DeliveryModeOpens a new window

Specifies the delivery mode of the message.

EnqueueTimeOpens a new window

Specifies the time when the message was enqueued.

ExceptionQueueOpens a new window

Specifies the name of the queue that the message is moved to if it cannot be processed successfully.

ExpirationOpens a new window

Specifies the duration, in seconds, for which an enqueued message is available for dequeuing before expiring.

MessageIdOpens a new window

Returns an array of message identifiers.

NotificationTypeOpens a new window

Indicates the type of notification such as regular, grouping, or timeout.

OriginalMessageIdOpens a new window

Specifies the ID of the message, in the last queue, that generated this message.

PriorityOpens a new window

Specifies the priority of the message.

QueueNameOpens a new window

Indicates the name of the queue that contains the message to be dequeued.

SenderIdOpens a new window

Identifies the original sender of the message.

StateOpens a new window

Specifies the state of the message.


OracleAQMessageAvailableEventArgs Constructor

This constructor creates an instance of the OracleAQMessageAvailableEventArgs class with default property values.

Declaration

// C#
public OracleAQMessageAvailableEventArgs();

OracleAQMessageAvailableEventArgs Properties

OracleAQMessageAvailableEventArgs properties are listed in Table 12-19Opens a new window.

Table 12-19 OracleAQMessageAvailableEventArgs Properties

Property Description

AvailableMessagesOpens a new window

Specifies the number of messages that raised this notification.

ConsumerNameOpens a new window

Provides the name of the consumer for which the message is available for dequeuing.

CorrelationOpens a new window

Provides the name of the consumer for which the message is available for dequeuing.

DelayOpens a new window

Specifies the duration, in seconds, after which an enqueued message is available for dequeuing.

DeliveryModeOpens a new window

Specifies the delivery mode of the message.

EnqueueTimeOpens a new window

Specifies the time when the message was enqueued.

ExceptionQueueOpens a new window

Specifies the name of the queue that the message is moved to if it cannot be processed successfully.

ExpirationOpens a new window

Specifies the duration, in seconds, for which an enqueued message is available for dequeuing before expiring.

MessageIdOpens a new window

Returns an array of message identifiers.

NotificationTypeOpens a new window

Indicates the type of notification such as regular, grouping, or timeout.

OriginalMessageIdOpens a new window

Specifies the ID of the message, in the last queue, that generated this message.

PriorityOpens a new window

Specifies the priority of the message.

QueueNameOpens a new window

Indicates the name of the queue that contains the message to be dequeued.

SenderIdOpens a new window

Identifies the original sender of the message.

StateOpens a new window

Specifies the state of the message.


AvailableMessages

This instance property specifies the number of messages that raised this notification.

Declaration

// C#
public int AvailableMessages{get;}

Property Value

An integer indicating the number of messages that raised this notification.

Remarks

The property value is 1 for a regular notification type. The notification type can be specified using the OracleAQQueue.Notification property.

This property is not relevant if the NotificationType is OracleAQNotificationType.Timeout.

ConsumerName

This property provides the name of the consumer for which the message is available for dequeuing.

Declaration

// C#
public string ConsumerName {get;}

Property Value

A string that identifies the name of the consumer.

Correlation

This instance property specifies the identification for the message.

Declaration

// C#
public string Correlation {get;}

Property Value

A string that specifies the identification for the message.

Remarks

This property specifies the correlation of the message for which the notification is raised. The consumer can then use this identification to dequeue specific messages by setting the "Correlation"Opens a new window property of the OracleAQDequeueOptions object.

Delay

This instance property specifies the duration, in seconds, after which an enqueued message is available for dequeuing.

Declaration

// C#
public int Delay {get;}

Property Value

An integer that indicates the duration, in seconds, after which an enqueued message is available for dequeuing.

DeliveryMode

This instance property specifies the delivery mode of the message.

Declaration

// C#
public OracleAQMessageDeliveryMode DeliveryMode {get;}

Property Value

An OracleAQMessageDeliveryMode enumerated value.

EnqueueTime

This instance property specifies the time when the message was enqueued.

Declaration

// C#
public DateTime EnqueueTime {get;}

Property Value

A DateTime object.

ExceptionQueue

This instance property specifies the name of the queue that the message is moved to if it cannot be processed successfully.

Declaration

// C#
public string ExceptionQueue {get;}

Property Value

The name of the queue that a message to is moved if it cannot be processed successfully.

Expiration

This instance property specifies the duration, in seconds, for which an enqueued message is available for dequeuing before expiring.

Declaration

// C#
public int Expiration {get;}

Property Value

An integer that specifies the duration, in seconds, for which an enqueued message is available for dequeuing.

MessageId

This instance property returns an array of message identifiers.

Declaration

// C#
public byte[][] MessageId{get;}

Property Value

A byte[][] that specifies the message identifiers received as part of the notification.

Remarks

This property specifies the message identifiers of the messages that raise the notification.

The size of the MessageId array is 1 for regular notifications. The size of the MessageId array is 1 for grouping notifications if the notification grouping type is OracleAQNotificationGroupingType.Last. This property is not relevant if the NotificationType is OracleAQNotificationType.Timeout.

NotificationType

This property indicates the type of notification such as regular, grouping, or timeout.

Declaration

// C#
public OracleAQNotificationType NotificationType {get;}

Property Value

An OracleAQNotificationType enum value.

OriginalMessageId

This property specifies the ID of the message, in the last queue, that generated this message.

Declaration

// C#
public byte[] OriginalMessageId {get;}

Property Value

A byte[] that specifies the original message ID.

Priority

This instance property specifies the priority of the message.

Declaration

// C#
public int Priority {get;}

Property Value

An integer that specifies the priority of the message.

QueueName

This property indicates the name of the queue that contains the message to be dequeued.

Declaration

// C#
public string QueueName {get;}

Property Value

A string.

SenderId

This property identifies the original sender of the message.

Declaration

// C#
public OracleAQAgent SenderId {get;}

Property Value

An OracleAQAgent object.

State

This instance property specifies the state of the message.

Declaration

// C#
public OracleAQMessageState State {get;}

Property Value

An OracleAQMessageState enumerated value.

Previous PageOpens a new window
Page 117 of 172
Next PageOpens a new window