DefaultPropertiesToSend コンストラクタ

.NET Framework クラス ライブラリ リファレンス

DefaultPropertiesToSend コンストラクタ

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

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DefaultPropertiesToSend

C#

public DefaultPropertiesToSend ()

C++

public:
DefaultPropertiesToSend ()

J#

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 つ目の方法を使う場合は、DefaultPropertiesToSend コンストラクタを明示的に呼び出す必要はありません。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 参照 (Visual Basic では Nothing)
TimeToBeReceived	Message.InfiniteTimeout
TimeToReachQueue	Message.InfiniteTimeout
TransactionStatusQueue	null 参照 (Visual Basic では Nothing)
UseAuthentication	false
UseDeadLetterQueue	false
UseEncryption	false
UseJournalQueue	false
UseTracing	false

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DefaultPropertiesToSend クラス
DefaultPropertiesToSend メンバ
System.Messaging 名前空間
AcknowledgeTypes 列挙体
EncryptionAlgorithm
HashAlgorithm
MessagePriority
InfiniteTimeout
DefaultPropertiesToSend
Message