Skip Headers
Oracle® Data Provider for .NET Developer's Guide
10g Release 2 (10.2)

Part Number B14307-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

OracleNotificationRequest Class

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


OracleNotificationRequest Members

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


OracleNotificationRequest Static Methods

The OracleNotificationRequest static method is listed in Table 7-15.

Table 7-15 OracleNotificationRequest Static Method

Static Method Description
Equals Inherited from Object


OracleNotificationRequest Properties

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

IsNotifiedOnce

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.

IsPersistent

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.

Timeout

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.


OracleNotificationRequest Methods

OracleNotificationRequest methods are listed in Table 7-17.

Table 7-17 OracleNotificationRequest Methods

Methods Description
Equals Inherited from Object
GetHashCode Inherited from Object
GetType Inherited from Object
ToString Inherited from Object