DefaultPropertiesToSend 构造函数
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
初始化 DefaultPropertiesToSend 类的新实例。
public:
DefaultPropertiesToSend();
public DefaultPropertiesToSend ();
Public Sub New ()
注解
可以创建 的新实例 DefaultPropertiesToSend ,以定义默认属性值,以与发送到非 类型 Message队列的对象相关联。 使用 MessageQueue 对象时,会为你创建一个 DefaultPropertiesToSend 实例, MessageQueue.DefaultPropertiesToSend 并与 的成员 MessageQueue相关联。
可通过两种方法定义要发送的队列的默认属性,如以下 C# 代码所示。 可以为 的此实例 DefaultPropertiesToSend 设置值,并将其与队列的 MessageQueue.DefaultPropertiesToSend 属性相关联:
DefaultPropertiesToSend myDefaultProperties = new DefaultPropertiesToSend();
// Set default values for the properties.
myDefaultProperties.Label = "myLabel";
myDefaultProperties.Recoverable = false;
...
myMessageQueue.DefaultPropertiesToSend = myDefaultProperties;
myMessageQueue.Send("hello");
或者,可以直接将 MessageQueue 值单独分配给实例的属性 DefaultPropertiesToSend :
myMessageQueue.DefaultPropertiesToSend.Label = "myLabel";
myMessageQueue.DefaultPropertiesToSend.Recoverable = false;
...
myMessageQueue.Send("hello");
如果选择其中第二个选项,则无需显式调用 DefaultPropertiesToSend 构造函数。 例如,如果属性的默认值依赖于所发送消息的某些条件,则可能需要创建 的实例 DefaultPropertiesToSend。 在将消息发送到队列MessageQueue.DefaultPropertiesToSend之前,可以创建多个DefaultPropertiesToSend实例,并将一个实例分配给队列的 属性。
下表显示了 实例 DefaultPropertiesToSend的初始属性值。
| 属性 | 初始值 |
|---|---|
| AcknowledgeType | AcknowledgeTypes.None |
| AdministrationQueue | null |
| AppSpecific | 0 |
| AttachSenderId | true |
| EncryptionAlgorithm | EncryptionAlgorithm.RC2 |
| Extension | 字节的零长度数组 |
| HashAlgorithm | HashAlgorithm.MD5 |
| Label | 空字符串 (“”) |
| Priority | MessagePriority.Normal |
| Recoverable | false |
| ResponseQueue | null |
| TimeToBeReceived | Message.InfiniteTimeout |
| TimeToReachQueue | Message.InfiniteTimeout |
| TransactionStatusQueue | null |
| UseAuthentication | false |
| UseDeadLetterQueue | false |
| UseEncryption | false |
| UseJournalQueue | false |
| UseTracing | false |