DefaultPropertiesToSend Constructor

public:
 DefaultPropertiesToSend();

public DefaultPropertiesToSend ();

Public Sub New ()

Remarks

You can create a new instance of DefaultPropertiesToSend to define default property values to associate with objects sent to a queue that are not of type Message. When working with MessageQueue objects, a DefaultPropertiesToSend instance is created for you and associated with the MessageQueue.DefaultPropertiesToSend member of the MessageQueue.

There are two ways to define a queue's default properties to send, as shown in the following C# code. You can set values for this instance of DefaultPropertiesToSend and associate it with the queue's MessageQueue.DefaultPropertiesToSend property:

DefaultPropertiesToSend myDefaultProperties = new DefaultPropertiesToSend();  
  // Set default values for the properties.  
  myDefaultProperties.Label = "myLabel";  
  myDefaultProperties.Recoverable = false;  
 ...  
  myMessageQueue.DefaultPropertiesToSend = myDefaultProperties;  
  myMessageQueue.Send("hello");  

Or, you can individually assign values to the MessageQueue instance's DefaultPropertiesToSend property directly:

myMessageQueue.DefaultPropertiesToSend.Label = "myLabel";  
  myMessageQueue.DefaultPropertiesToSend.Recoverable = false;  
...  
  myMessageQueue.Send("hello");  

If you choose the second of these options, you do not need to call the DefaultPropertiesToSend constructor explicitly. You might want to create instances of DefaultPropertiesToSend, for example, if the properties' default values depend on some criterion of the message being sent. You can create multiple DefaultPropertiesToSend instances and assign one to the queue's MessageQueue.DefaultPropertiesToSend property before sending the message to the queue.

The following table shows initial property values for an instance of DefaultPropertiesToSend.

Applies to

See also

• AcknowledgeTypes
• EncryptionAlgorithm
• HashAlgorithm
• MessagePriority
• InfiniteTimeout
• DefaultPropertiesToSend
• Message