DefaultPropertiesToSend コンストラクタ
DefaultPropertiesToSend クラスの新しいインスタンスを初期化します。
Public Sub New()
[C#]
public DefaultPropertiesToSend();
[C++]
public: DefaultPropertiesToSend();
[JScript]
public function DefaultPropertiesToSend();
解説
DefaultPropertiesToSend の新しいインスタンスを作成することで、キューに送信される Message 型以外のオブジェクトに関連付けるプロパティの既定値を定義できます。 MessageQueue オブジェクトを使うときには、 DefaultPropertiesToSend インスタンスが作成され、 MessageQueue の MessageQueue.DefaultPropertiesToSend メンバに関連付けられます。
オブジェクトを送信するキューのプロパティの既定値を定義する方法は、次の C# のコードに示ように 2 とおりあります。1 つ目の方法として、 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");
もう 1 つの方法として、 MessageQueue インスタンスの DefaultPropertiesToSend プロパティに値を個別に直接割り当てることもできます。
myMessageQueue.DefaultPropertiesToSend.Label = "myLabel";
myMessageQueue.DefaultPropertiesToSend.Recoverable = false;
...
myMessageQueue.Send("hello");
2 つ目の方法を使う場合は、 ctor コンストラクタを明示的に呼び出す必要はありません。 DefaultPropertiesToSend のインスタンスを作成する必要がある場合があります。たとえば、送信するメッセージの条件に応じてプロパティの既定値が変化する場合です。このような場合は、複数の DefaultPropertiesToSend インスタンスを作成して、キューにメッセージを送信する前に、キューの MessageQueue.DefaultPropertiesToSend プロパティにインスタンスの 1 つを割り当てることができます。
次の表は、 DefaultPropertiesToSend のインスタンスのプロパティの初期値を示します。
| プロパティ | 初期値 |
|---|---|
| AcknowledgeType | AcknowledgeTypes.None |
| AdministrationQueue | null 参照 (Visual Basic では Nothing) |
| AppSpecific | 0 |
| AttachSenderId | true |
| EncryptionAlgorithm | EncryptionAlgorithm.RC2 |
| Extension | 長さ 0 のバイト配列。 |
| HashAlgorithm | HashAlgorithm.MD5 |
| Label | 空の文字列 ("")。 |
| Priority | MessagePriority.Normal |
| Recoverable | false |
| ResponseQueue | null 参照 (Nothing) |
| TimeToBeReceived | Message.InfiniteTimeout |
| TimeToReachQueue | Message.InfiniteTimeout |
| TransactionStatusQueue | null 参照 (Nothing) |
| UseAuthentication | false |
| UseDeadLetterQueue | false |
| UseEncryption | false |
| UseJournalQueue | false |
| UseTracing | false |
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
DefaultPropertiesToSend クラス | DefaultPropertiesToSend メンバ | System.Messaging 名前空間 | AcknowledgeTypes | EncryptionAlgorithm | HashAlgorithm | MessagePriority | InfiniteTimeout | DefaultPropertiesToSend | Message