Oracle® Data Provider for .NET Developer's Guide 10g Release 2 (10.2) Part Number B14307-01 |
|
|
View PDF |
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.
Class Inheritance
Object
OracleNotificationRequest
Declaration
// C# public sealed class OracleNotificationRequest
Thread Safety
All public static methods are thread-safe, although methods do not guarantee thread safety.
Requirements
Namespace: Oracle.DataAccess.Client
Assembly: Oracle.DataAccess.dll
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 7-12.
Table 7-12 OracleNotificationRequest Static Method
Static Method | Description |
---|---|
Equals |
Inherited from Object |
OracleNotificationRequest Properties
OracleNotificationRequest
properties are listed in Table 7-13.
Table 7-13 OracleNotificationRequest Properties
Properties | Description |
---|---|
IsNotifiedOnce |
Indicates whether or not the registration is to be removed upon notification |
IsPersistent |
Indicates whether or not the invalidation message should be queued persistently in the database before delivery |
Timeout |
Specifies the time that the registration remains alive |
OracleNotificationRequest Methods
OracleNotificationRequest
methods are listed in Table 7-14.
Table 7-14 OracleNotificationRequest Methods
Methods | Description |
---|---|
Equals |
Inherited from Object |
GetHashCode |
Inherited from Object |
GetType |
Inherited from Object |
ToString |
Inherited from Object |
See Also:
The OracleNotificationRequest
static method is listed in Table 7-15.
Table 7-15 OracleNotificationRequest Static Method
Static Method | Description |
---|---|
Equals |
Inherited from Object |
See Also:
The OracleNotificationRequest
properties are listed in Table 7-16.
Table 7-16 OracleNotificationRequest Properties
Properties | Description |
---|---|
IsNotifiedOnce |
Indicates whether or not the registration is to be removed upon notification |
IsPersistent |
Indicates whether or not the invalidation message should be queued persistently in the database before delivery |
Timeout |
Specifies the time that the registration remains alive |
See Also:
This property indicates whether or not the registration is to be removed upon notification.
Declaration
// C# public bool IsNotifiedOnce{get; set;}
Property Value
A bool
value that indicates whether or not the registration is to be removed upon notification.
Remarks
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.
Declaration
// C# public bool IsPersistent{get; set;}
Property Value
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.
Remarks
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 that the registration remains alive.
Declaration
// C# public long Timeout{get; set}
Property Value
A long
value that specifies the time that the registration remains alive. The valid values for the Timeout
property are between 0
and 4294967295
.
Exceptions
ArgumentOutOfRangeException
- The specified Timeout
is invalid.
Remarks
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 7-17.