An OracleNotificationRequest class represents a notification request to be subscribed in the database. It contains information about the request and the characteristics of the notification. Using the OracleNotificationRequest class, Oracle Data Provider for .NET can create the notification registration in the database.
System.Object
Oracle.DataAccess.Client.OracleNotificationRequest
// C# public sealed class OracleNotificationRequest
All public static methods are thread-safe, although methods do not guarantee thread safety.
Namespace: Oracle.DataAccess.Client
Assembly: Oracle.DataAccess.dll
Microsoft .NET Framework Version: 1.x or 2.0
Comment: Not supported in a .NET stored procedure
See Also:
OracleNotificationRequest members are listed in the following tables:
OracleNotificationRequest Static Method
The OracleNotificationRequest static method is listed in Table 8-12.
Table 8-12 OracleNotificationRequest Static Method
| Static Method | Description |
|---|---|
|
|
Inherited from |
OracleNotificationRequest Properties
OracleNotificationRequest properties are listed in Table 8-13.
Table 8-13 OracleNotificationRequest Properties
| Properties | Description |
|---|---|
|
Indicates whether or not the registration is to be removed upon notification |
|
|
Indicates whether or not the invalidation message should be queued persistently in the database before delivery |
|
|
Specifies the time that the registration remains alive |
OracleNotificationRequest Methods
OracleNotificationRequest methods are listed in Table 8-14.
Table 8-14 OracleNotificationRequest Methods
| Methods | Description |
|---|---|
|
|
Inherited from |
|
|
Inherited from |
|
|
Inherited from |
|
|
Inherited from |
See Also:
The OracleNotificationRequest static method is listed in Table 8-15.
Table 8-15 OracleNotificationRequest Static Method
| Static Method | Description |
|---|---|
|
|
Inherited from |
See Also:
The OracleNotificationRequest properties are listed in Table 8-16.
Table 8-16 OracleNotificationRequest Properties
| Properties | Description |
|---|---|
|
Indicates whether or not the registration is to be removed upon notification |
|
|
Indicates whether or not the invalidation message should be queued persistently in the database before delivery |
|
|
Specifies the time that the registration remains alive |
See Also:
This property indicates whether or not the registration is to be removed upon notification.
// C#
public bool IsNotifiedOnce{get; set;}
A bool value that indicates whether or not the registration is to be removed upon notification.
Default is true.
Modifying this property after the completion of a successful registration has no effect.
See Also:
This property indicates whether or not the invalidation message should be queued persistently in the database before delivery.
// C#
public bool IsPersistent{get; set;}
A bool value that indicates whether or not the invalidation message should be queued persistently in the database before delivery.
When the IsPersistent property is set to True, the message is queued persistently in the database and cannot be lost upon database failures or shutdowns. When the IsPersistent property is set to False, the message is stored in an in-memory queue before delivery and could be lost.
This property does not apply to NotificationRegistration which is always persistent.
This property only applies to the notification message after it has been sent.
Default is false.
Modifying this property after the completion of a successful registration has no effect.
The database performs faster if the message is stored in an in-memory queue rather than a database queue.
See Also:
This property specifies the time, in seconds, that the registration remains alive.
// C#
public long Timeout{get; set}
A long value that specifies the time, in seconds, that the registration remains alive. The valid values for the Timeout property are between 0 and 4294967295. The default is 50000.
ArgumentOutOfRangeException - The specified Timeout is invalid.
Modifying this property after the completion of a successful registration has no effect.
When the Timeout property is set to 0, the registration does not expire.
When the registration is removed because the registration has expired, the database sends a notification indicating the expiration.
See Also:
OracleNotificationRequest methods are listed in Table 8-17.