DefaultPropertiesToSend クラス
アセンブリ: System.Messaging (system.messaging.dll 内)
構文
解説
MessageQueue に送信されるメッセージ用に選択されるプロパティの既定値を設定できます。DefaultPropertiesToSend は、Message インスタンス以外のオブジェクトがキューに送信されるときに、送信されるメッセージのプロパティの既定値を指定するために使用されます。たとえば、コード片 myMessageQueue.Send("hello") で Send メソッドに渡される文字列引数などです。Message クラスには、DefaultPropertiesToSend 内のプロパティに対応する同じ名前のプロパティがあります。前者のプロパティは Message インスタンスを送信するときに値を提供します。キューの MessageQueue.DefaultPropertiesToSend を指定していても、そのキューに Message オブジェクトを送信すると、キューの DefaultPropertiesToSend の値は、同じ名前の Message プロパティの値によってオーバーライドされます。
明示的に設定しないプロパティは、コントラクタ DefaultPropertiesToSend によって指定される既定値に設定されます。
DefaultPropertiesToSend のインスタンスの初期プロパティ値の一覧については、DefaultPropertiesToSend コンストラクタのトピックを参照してください。
メッセージの優先順位を使用して、メッセージを送信するときの既定のプロパティを決定するコード例を次に示します。
Imports System Imports System.Messaging Public Class MyNewQueue ' Provides an entry point into the application. ' ' This example specifies different types of default ' properties for messages. Public Shared Sub Main() ' Create a new instance of the class. Dim myNewQueue As New MyNewQueue() ' Send normal and high priority messages. myNewQueue.SendNormalPriorityMessages() myNewQueue.SendHighPriorityMessages() Return End Sub 'Main ' Associates selected message property values ' with high priority messages. Public Sub SendHighPriorityMessages() ' Connect to a message queue. Dim myQueue As New MessageQueue(".\myQueue") ' Associate selected default property values with high ' priority messages. myQueue.DefaultPropertiesToSend.Priority = _ MessagePriority.High myQueue.DefaultPropertiesToSend.Label = _ "High Priority Message" myQueue.DefaultPropertiesToSend.Recoverable = True myQueue.DefaultPropertiesToSend.TimeToReachQueue = _ New TimeSpan(0, 0, 30) ' Send messages using these defaults. myQueue.Send("High priority message data 1.") myQueue.Send("High priority message data 2.") myQueue.Send("High priority message data 3.") Return End Sub 'SendHighPriorityMessages ' Associates selected message property values ' with normal priority messages. Public Sub SendNormalPriorityMessages() ' Connect to a message queue. Dim myQueue As New MessageQueue(".\myQueue") ' Associate selected default property values with normal ' priority messages. myQueue.DefaultPropertiesToSend.Priority = _ MessagePriority.Normal myQueue.DefaultPropertiesToSend.Label = _ "Normal Priority Message" myQueue.DefaultPropertiesToSend.Recoverable = False myQueue.DefaultPropertiesToSend.TimeToReachQueue = _ New TimeSpan(0, 2, 0) ' Send messages using these defaults. myQueue.Send("Normal priority message data 1.") myQueue.Send("Normal priority message data 2.") myQueue.Send("Normal priority message data 3.") Return End Sub 'SendNormalPriorityMessages End Class 'MyNewQueue
using System; using System.Messaging; namespace MyProject { /// <summary> /// Provides a container class for the example. /// </summary> public class MyNewQueue { //************************************************** // Provides an entry point into the application. // // This example specifies different types of default // properties for messages. //************************************************** public static void Main() { // Create a new instance of the class. MyNewQueue myNewQueue = new MyNewQueue(); // Send normal and high priority messages. myNewQueue.SendNormalPriorityMessages(); myNewQueue.SendHighPriorityMessages(); return; } //************************************************** // Associates selected message property values // with high priority messages. //************************************************** public void SendHighPriorityMessages() { // Connect to a message queue. MessageQueue myQueue = new MessageQueue(".\\myQueue"); // Associate selected default property values with high // priority messages. myQueue.DefaultPropertiesToSend.Priority = MessagePriority.High; myQueue.DefaultPropertiesToSend.Label = "High Priority Message"; myQueue.DefaultPropertiesToSend.Recoverable = true; myQueue.DefaultPropertiesToSend.TimeToReachQueue = new TimeSpan(0,0,30); // Send messages using these defaults. myQueue.Send("High priority message data 1."); myQueue.Send("High priority message data 2."); myQueue.Send("High priority message data 3."); return; } //************************************************** // Associates selected message property values // with normal priority messages. //************************************************** public void SendNormalPriorityMessages() { // Connect to a message queue. MessageQueue myQueue = new MessageQueue(".\\myQueue"); // Associate selected default property values with normal // priority messages. myQueue.DefaultPropertiesToSend.Priority = MessagePriority.Normal; myQueue.DefaultPropertiesToSend.Label = "Normal Priority Message"; myQueue.DefaultPropertiesToSend.Recoverable = false; myQueue.DefaultPropertiesToSend.TimeToReachQueue = new TimeSpan(0,2,0); // Send messages using these defaults. myQueue.Send("Normal priority message data 1."); myQueue.Send("Normal priority message data 2."); myQueue.Send("Normal priority message data 3."); return; } } }
#using <system.dll> #using <system.messaging.dll> using namespace System; using namespace System::Messaging; ref class MyNewQueue { public: // Associates selected message property values // with high priority messages. void SendHighPriorityMessages() { // Connect to a message queue. MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" ); // Associate selected default property values with high // priority messages. myQueue->DefaultPropertiesToSend->Priority = MessagePriority::High; myQueue->DefaultPropertiesToSend->Label = "High Priority Message"; myQueue->DefaultPropertiesToSend->Recoverable = true; myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,0,30); // Send messages using these defaults. myQueue->Send( "High priority message data 1." ); myQueue->Send( "High priority message data 2." ); myQueue->Send( "High priority message data 3." ); return; } // Associates selected message property values // with normal priority messages. void SendNormalPriorityMessages() { // Connect to a message queue. MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" ); // Associate selected default property values with normal // priority messages. myQueue->DefaultPropertiesToSend->Priority = MessagePriority::Normal; myQueue->DefaultPropertiesToSend->Label = "Normal Priority Message"; myQueue->DefaultPropertiesToSend->Recoverable = false; myQueue->DefaultPropertiesToSend->TimeToReachQueue = TimeSpan(0,2,0); // Send messages using these defaults. myQueue->Send( "Normal priority message data 1." ); myQueue->Send( "Normal priority message data 2." ); myQueue->Send( "Normal priority message data 3." ); return; } }; // Provides an entry point into the application. // This example specifies different types of default // properties for messages. int main() { // Create a new instance of the class. MyNewQueue^ myNewQueue = gcnew MyNewQueue; // Send normal and high priority messages. myNewQueue->SendNormalPriorityMessages(); myNewQueue->SendHighPriorityMessages(); return 0; }
package MyProject; import System.*; import System.Messaging.*; /// <summary> /// Provides a container class for the example. /// </summary> public class MyNewQueue { //************************************************** // Provides an entry point into the application. // // This example specifies different types of default // properties for messages. //************************************************** public static void main(String[] args) { // Create a new instance of the class. MyNewQueue myNewQueue = new MyNewQueue(); // Send normal and high priority messages. myNewQueue.SendNormalPriorityMessages(); myNewQueue.SendHighPriorityMessages(); return; } //main //************************************************** // Associates selected message property values // with high priority messages. //************************************************** public void SendHighPriorityMessages() { // Connect to a message queue. MessageQueue myQueue = new MessageQueue(".\\myQueue"); // Associate selected default property values with high // priority messages. myQueue.get_DefaultPropertiesToSend(). set_Priority(MessagePriority.High); myQueue.get_DefaultPropertiesToSend(). set_Label("High Priority Message"); myQueue.get_DefaultPropertiesToSend(). set_Recoverable(true); myQueue.get_DefaultPropertiesToSend(). set_TimeToReachQueue(new TimeSpan(0, 0, 30)); // Send messages using these defaults. myQueue.Send("High priority message data 1."); myQueue.Send("High priority message data 2."); myQueue.Send("High priority message data 3."); return; } //SendHighPriorityMessages //************************************************** // Associates selected message property values // with normal priority messages. //************************************************** public void SendNormalPriorityMessages() { // Connect to a message queue. MessageQueue myQueue = new MessageQueue(".\\myQueue"); // Associate selected default property values with normal // priority messages. myQueue.get_DefaultPropertiesToSend(). set_Priority(MessagePriority.Normal); myQueue.get_DefaultPropertiesToSend(). set_Label("Normal Priority Message"); myQueue.get_DefaultPropertiesToSend(). set_Recoverable(false); myQueue.get_DefaultPropertiesToSend(). set_TimeToReachQueue(new TimeSpan(0, 2, 0)); // Send messages using these defaults. myQueue.Send("Normal priority message data 1."); myQueue.Send("Normal priority message data 2."); myQueue.Send("Normal priority message data 3."); return; } //SendNormalPriorityMessages } //MyNewQueue
System.Messaging.DefaultPropertiesToSend
プラットフォーム
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
- DefaultPropertiesToSend クラスのページへのリンク