DefaultPropertiesToSend 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 DefaultPropertiesToSend 類別的新執行個體。
public:
DefaultPropertiesToSend();
public DefaultPropertiesToSend ();
Public Sub New ()
備註
您可以建立 的新實例 DefaultPropertiesToSend ,以定義預設屬性值,以便與傳送至不是 型 Message 別之佇列的物件產生關聯。 使用 MessageQueue 物件時, DefaultPropertiesToSend 會為您建立 實例,並與 的成員 MessageQueue 相關聯 MessageQueue.DefaultPropertiesToSend 。
有兩種方式可以定義佇列的預設屬性來傳送,如下列 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 。 您可以建立多個 DefaultPropertiesToSend 實例,並將一個實例指派給佇列的 MessageQueue.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 |