CreateQueue(String,Boolean,String,OracleConnection) Method

In This Topic

Syntax
Remarks
Requirements
See Also

This function creates a nonpersistent RAW queue.

Syntax

Visual Basic
C#

public static OracleQueue CreateQueue( 
   string name,
   bool multipleConsumers,
   string comment,
   OracleConnection connection
)

'Declaration
 
Public Overloads Shared Function CreateQueue( _
   ByVal name As String, _
   ByVal multipleConsumers As Boolean, _
   ByVal comment As String, _
   ByVal connection As OracleConnection _
) As OracleQueue

Parameters

name: Unique name of the queue to be created.
multipleConsumers: FALSE means queues created in the table can only have one consumer for each message. TRUE means queues created in the table can have multiple consumers for each message.
comment: User-specified description of the queue.
connection: An OracleConnection to the Oracle server, which provides the AQ functionality.

Return Value

Returns OracleQueue instance, which corresponds to the queue created on a server.

Remarks

The queue may be either single-consumer or multiconsumer queue. All queue names must be unique within a schema. The queues are created in a 8.1-compatible or higher system-created queue table (AQ$_MEM_SC or AQ$_MEM_MC) in the same schema as that specified by the queue name. After a queue is created, it can be enabled by calling StartQueue method. By default, the queue is created with both enqueue and dequeue disabled. You cannot dequeue from a nonpersistent queue. The only way to retrieve a message from a nonpersistent queue is by using the asynchrone notification mechanism. You cannot invoke the Listen call on a nonpersistent queue.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

OracleQueueAdmin Class
OracleQueueAdmin Members
Overload List
DropQueue Method

Send Feedback