DefaultPropertiesToSend コンストラクター

定義

DefaultPropertiesToSend クラスの新しいインスタンスを初期化します。

public:
 DefaultPropertiesToSend();
public DefaultPropertiesToSend ();
Public Sub New ()

注釈

の新しいインスタンス DefaultPropertiesToSend を作成して、 型 Messageではないキューに送信されるオブジェクトに関連付ける既定のプロパティ値を定義できます。 オブジェクトをMessageQueue操作する場合、DefaultPropertiesToSendインスタンスが自動的に作成され、 MessageQueueのメンバーにMessageQueue.DefaultPropertiesToSend関連付けられます。

次の C# コードに示すように、送信するキューの既定のプロパティを定義する方法は 2 つあります。 のこのインスタンスの 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");  

または、インスタンスDefaultPropertiesToSendのプロパティに値をMessageQueue直接個別に割り当てることができます。

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

これらのオプションの 2 つ目を選択した場合、コンストラクターを明示的に呼び出す DefaultPropertiesToSend 必要はありません。 たとえば、プロパティの DefaultPropertiesToSend既定値が送信されるメッセージの条件に依存する場合など、 のインスタンスを作成できます。 メッセージをキューに送信する前に、複数 DefaultPropertiesToSend のインスタンスを作成し、1 つをキューの MessageQueue.DefaultPropertiesToSend プロパティに割り当てることができます。

のインスタンスの初期プロパティ値を次の DefaultPropertiesToSend表に示します。

プロパティ 初期値
AcknowledgeType AcknowledgeTypes.None
AdministrationQueue null
AppSpecific 0
AttachSenderId true
EncryptionAlgorithm EncryptionAlgorithm.RC2
Extension バイトの長さ 0 の配列
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

適用対象

こちらもご覧ください