MessageQueue.DenySharedReceive Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether this MessageQueue has exclusive access to receive messages from the Message Queuing queue.
public:
property bool DenySharedReceive { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_DenySharedReceive")]
public bool DenySharedReceive { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_DenySharedReceive")>]
member this.DenySharedReceive : bool with get, set
Public Property DenySharedReceive As Boolean
Property Value
true
if this MessageQueue has exclusive rights to receive messages from the queue; otherwise, false
. The default is false
.
- Attributes
Examples
The following code example gets and sets the value of a message queue's DenySharedReceive property.
// Set the queue's DenySharedReceive property value.
queue.DenySharedReceive = false;
// Display the new value of the queue's DenySharedReceive property.
Console.WriteLine("MessageQueue.DenySharedReceive: {0}",
queue.DenySharedReceive);
Remarks
DenySharedReceive specifies the shared mode of the queue referenced by this MessageQueue. Set DenySharedReceive to true
to indicate that only this MessageQueue should have access to peek or receive messages from the queue with the specified Path. If another MessageQueue or another application is associated with the same queue resource, that instance or application will not be able to peek or receive messages, but it can still send them.
If DenySharedReceive is false
, the queue is available to multiple applications for sending, peeking, or receiving messages.
The following table shows whether this property is available in various Workgroup modes.
Workgroup mode | Available |
---|---|
Local computer | Yes |
Local computer and direct format name | Yes |
Remote computer | Yes |
Remote computer and direct format name | Yes |