次の方法で共有


DefaultPropertiesToSend コンストラクター

定義

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

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

注釈

DefaultPropertiesToSendの新しいインスタンスを作成して、Message型ではないキューに送信されたオブジェクトに関連付ける既定のプロパティ値を定義できます。 MessageQueue オブジェクトを操作すると、DefaultPropertiesToSend インスタンスが自動的に作成され、MessageQueueMessageQueue.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");

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

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

適用対象

こちらもご覧ください