MessageQueue.Send メソッド

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

キューにオブジェクトを送信します。

オーバーロード

Send(Object)	この MessageQueue で参照される非トランザクション キューにオブジェクトを送信します。
Send(Object, MessageQueueTransaction)	この MessageQueue で参照されるトランザクション キューにオブジェクトを送信します。
Send(Object, MessageQueueTransactionType)	この MessageQueue で参照されるキューにオブジェクトを送信します。
Send(Object, String)	この MessageQueue で参照される非トランザクション キューにオブジェクトを送信し、メッセージのラベルを指定します。
Send(Object, String, MessageQueueTransaction)	この MessageQueue で参照されるトランザクション キューにオブジェクトを送信し、メッセージのラベルを指定します。
Send(Object, String, MessageQueueTransactionType)	この MessageQueue で参照されるキューにオブジェクトを送信し、メッセージのラベルを指定します。

Send(Object)

この MessageQueue で参照される非トランザクション キューにオブジェクトを送信します。

public:
 void Send(System::Object ^ obj);

public void Send (object obj);

member this.Send : obj -> unit

Public Sub Send (obj As Object)

パラメーター

obj

Object

キューに送信するオブジェクト。

例外

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例では、メッセージ キューに接続し、キューにメッセージを送信します。

#using <system.dll>
#using <system.messaging.dll.>

using namespace System;
using namespace System::Messaging;
ref class MyNewQueue
{
public:
   void SendMessage()
   {
      
      // Connect to a queue on the local computer.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myQueue" );
      
      // Send a message to the queue.
      if ( myQueue->Transactional == true )
      {
         
         // Create a transaction.
         MessageQueueTransaction^ myTransaction = gcnew MessageQueueTransaction;
         
         // Begin the transaction.
         myTransaction->Begin();
         
         // Send the message.
         myQueue->Send( "My Message Data.", myTransaction );
         
         // Commit the transaction.
         myTransaction->Commit();
      }
      else
      {
         myQueue->Send( "My Message Data." );
      }

      return;
   }

};

int main()
{
   
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;
   
   // Send a message to a queue.
   myNewQueue->SendMessage();
   return 0;
}

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 sends a message to a queue.
        //**************************************************

        public static void Main()
        {
            // Create a new instance of the class.
            MyNewQueue myNewQueue = new MyNewQueue();

            // Send a message to a queue.
            myNewQueue.SendMessage();

            return;
        }

        //**************************************************
        // Sends a message to a queue.
        //**************************************************
        
        public void SendMessage()
        {
                        
            // Connect to a queue on the local computer.
            MessageQueue myQueue = new MessageQueue(".\\myQueue");

            // Send a message to the queue.
            if (myQueue.Transactional == true)
            {
                // Create a transaction.
                MessageQueueTransaction myTransaction = new
                    MessageQueueTransaction();

                // Begin the transaction.
                myTransaction.Begin();

                // Send the message.
                myQueue.Send("My Message Data.", myTransaction);

                // Commit the transaction.
                myTransaction.Commit();
            }
            else
            {
                myQueue.Send("My Message Data.");
            }

            return;
        }
    }
}

Imports System.Messaging

Public Class MyNewQueue


        '
        ' Provides an entry point into the application.
        ' 
        ' This example sends a message to a queue.
        '

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue

            ' Send a message to a queue.
            myNewQueue.SendMessage()

            Return

        End Sub


        '
        ' Sends a message to a queue.
        '

        Public Sub SendMessage()

            ' Connect to a queue on the local computer.
            Dim myQueue As New MessageQueue(".\myQueue")

            ' Send a message to the queue.
            If myQueue.Transactional = True Then

                ' Create a transaction.
                Dim myTransaction As New MessageQueueTransaction

                ' Begin the transaction.
                myTransaction.Begin()

                ' Send the message.
                myQueue.Send("My Message Data.", myTransaction)

                ' Commit the transaction.
                myTransaction.Commit()

            Else
                myQueue.Send("My Message Data.")
            End If

            Return

        End Sub

End Class

次のコード例では、アプリケーション定義 Order クラスをキューに送信し、そのキューからメッセージを受信します。

注釈

パラメーターを含む obj メッセージを によって参照されるキューに送信するには、このオーバーロードを MessageQueue使用します。 キューに送信するオブジェクトには、 または 任意の Message マネージド オブジェクトを指定できます。 以外 Messageのオブジェクトを送信すると、オブジェクトがシリアル化され、メッセージの本文に挿入されます。

このオーバーロードを使用してトランザクション キューにメッセージを送信すると、メッセージは配信不能キューに送信されます。 メッセージを他のメッセージを含むトランザクションの一部にする場合は、 または MessageQueueTransactionType をパラメーターとして受け取るMessageQueueTransactionオーバーロードを使用します。

を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先順位などを指定した場合、これらの値は、アプリケーションがキューに送信するときに、型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信すると、 に設定 Message されたプロパティ値が優先 DefaultPropertiesToSend され、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• DefaultPropertiesToSend
• Message
• Path
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()

Send(Object, MessageQueueTransaction)

この MessageQueue で参照されるトランザクション キューにオブジェクトを送信します。

public:
 void Send(System::Object ^ obj, System::Messaging::MessageQueueTransaction ^ transaction);

public void Send (object obj, System.Messaging.MessageQueueTransaction transaction);

member this.Send : obj * System.Messaging.MessageQueueTransaction -> unit

Public Sub Send (obj As Object, transaction As MessageQueueTransaction)

パラメーター

obj

Object

キューに送信するオブジェクト。

transaction

MessageQueueTransaction

MessageQueueTransaction オブジェクト。

例外

ArgumentNullException

transaction パラメーターが null です。

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キュー アプリケーションが、トランザクションの使用が正しくないことを示しました。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例では、トランザクション キューに文字列を送信し、そのキューからメッセージを受信します。

#using <system.dll>
#using <system.messaging.dll>

using namespace System;
using namespace System::Messaging;

/// <summary>
/// Provides a container class for the example.
/// </summary>
ref class MyNewQueue
{
public:

   //*************************************************
   // Sends a message to a queue.
   //*************************************************
   void SendMessageTransactional()
   {
      // Connect to a queue on the local computer.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myTransactionalQueue" );

      // Send a message to the queue.
      if ( myQueue->Transactional == true )
      {
         // Create a transaction.
         MessageQueueTransaction^ myTransaction = gcnew MessageQueueTransaction;

         // Begin the transaction.
         myTransaction->Begin();

         // Send the message.
         myQueue->Send( "My Message Data.", myTransaction );

         // Commit the transaction.
         myTransaction->Commit();
      }

      return;
   }


   //*************************************************
   // Receives a message containing an Order.
   //*************************************************
   void ReceiveMessageTransactional()
   {
      // Connect to a transactional queue on the local computer.
      MessageQueue^ myQueue = gcnew MessageQueue( ".\\myTransactionalQueue" );

      // Set the formatter.
      array<Type^>^p = gcnew array<Type^>(1);
      p[ 0 ] = String::typeid;
      myQueue->Formatter = gcnew XmlMessageFormatter( p );

      // Create a transaction.
      MessageQueueTransaction^ myTransaction = gcnew MessageQueueTransaction;
      try
      {
         // Begin the transaction.
         myTransaction->Begin();

         // Receive the message. 
         Message^ myMessage = myQueue->Receive( myTransaction );
         String^ myOrder = static_cast<String^>(myMessage->Body);

         // Display message information.
         Console::WriteLine( myOrder );

         // Commit the transaction.
         myTransaction->Commit();
      }
      catch ( MessageQueueException^ e ) 
      {
         // Handle nontransactional queues.
         if ( e->MessageQueueErrorCode == MessageQueueErrorCode::TransactionUsage )
         {
            Console::WriteLine( "Queue is not transactional." );
         }

         // Else catch other sources of MessageQueueException.
         // Roll back the transaction.
         myTransaction->Abort();
      }

      // Catch other exceptions as necessary, such as 
      // InvalidOperationException, thrown when the formatter 
      // cannot deserialize the message.
      return;
   }
};

//*************************************************
// Provides an entry point into the application.
// 
// This example sends and receives a message from
// a transactional queue.
//*************************************************
int main()
{
   // Create a new instance of the class.
   MyNewQueue^ myNewQueue = gcnew MyNewQueue;

   // Send a message to a queue.
   myNewQueue->SendMessageTransactional();

   // Receive a message from a queue.
   myNewQueue->ReceiveMessageTransactional();
   return 0;
}

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 sends and receives a message from
        // a transactional queue.
        //**************************************************

        public static void Main()
        {
            // Create a new instance of the class.
            MyNewQueue myNewQueue = new MyNewQueue();

            // Send a message to a queue.
            myNewQueue.SendMessageTransactional();

            // Receive a message from a queue.
            myNewQueue.ReceiveMessageTransactional();
        
            return;
        }

        //**************************************************
        // Sends a message to a queue.
        //**************************************************
        
        public void SendMessageTransactional()
        {
                        
            // Connect to a queue on the local computer.
            MessageQueue myQueue = new
                MessageQueue(".\\myTransactionalQueue");

            // Send a message to the queue.
            if (myQueue.Transactional == true)
            {
                // Create a transaction.
                MessageQueueTransaction myTransaction = new
                    MessageQueueTransaction();

                // Begin the transaction.
                myTransaction.Begin();

                // Send the message.
                myQueue.Send("My Message Data.", myTransaction);

                // Commit the transaction.
                myTransaction.Commit();
            }

            return;
        }

        //**************************************************
        // Receives a message containing an Order.
        //**************************************************
        
        public  void ReceiveMessageTransactional()
        {
            // Connect to a transactional queue on the local computer.
            MessageQueue myQueue = new
                MessageQueue(".\\myTransactionalQueue");

            // Set the formatter.
            myQueue.Formatter = new XmlMessageFormatter(new Type[]
                {typeof(String)});
            
            // Create a transaction.
            MessageQueueTransaction myTransaction = new
                MessageQueueTransaction();

            try
            {
                // Begin the transaction.
                myTransaction.Begin();
                
                // Receive the message.
                Message myMessage =	myQueue.Receive(myTransaction);
                String myOrder = (String)myMessage.Body;

                // Display message information.
                Console.WriteLine(myOrder);

                // Commit the transaction.
                myTransaction.Commit();
            }
            
            catch (MessageQueueException e)
            {
                // Handle nontransactional queues.
                if (e.MessageQueueErrorCode ==
                    MessageQueueErrorCode.TransactionUsage)
                {
                    Console.WriteLine("Queue is not transactional.");
                }
                
                // Else catch other sources of MessageQueueException.

                // Roll back the transaction.
                myTransaction.Abort();
            }

            // Catch other exceptions as necessary, such as
            // InvalidOperationException, thrown when the formatter
            // cannot deserialize the message.

            return;
        }
    }
}

Imports System.Messaging

   
Public Class MyNewQueue


        '
        ' Provides an entry point into the application.
        ' 
        ' This example sends and receives a message from
        ' a transactional queue.
        '

        Public Shared Sub Main()

            ' Create a new instance of the class.
            Dim myNewQueue As New MyNewQueue

            ' Send a message to a queue.
            myNewQueue.SendMessageTransactional()

            ' Receive a message from a queue.
            myNewQueue.ReceiveMessageTransactional()

            Return

        End Sub


        '
        ' Sends a message to a queue.
        '

        Public Sub SendMessageTransactional()

            ' Connect to a queue on the local computer.
            Dim myQueue As New MessageQueue(".\myTransactionalQueue")

            ' Send a message to the queue.
            If myQueue.Transactional = True Then
                ' Create a transaction.
                Dim myTransaction As New MessageQueueTransaction

                ' Begin the transaction.
                myTransaction.Begin()

                ' Send the message.
                myQueue.Send("My Message Data.", myTransaction)

                ' Commit the transaction.
                myTransaction.Commit()
            End If

            Return

        End Sub


        '
        ' Receives a message containing an Order.
        '

        Public Sub ReceiveMessageTransactional()

            ' Connect to a transactional queue on the local computer.
            Dim myQueue As New MessageQueue(".\myTransactionalQueue")

            ' Set the formatter.
            myQueue.Formatter = New XmlMessageFormatter(New Type() _
                {GetType([String])})

            ' Create a transaction.
            Dim myTransaction As New MessageQueueTransaction

            Try

                ' Begin the transaction.
                myTransaction.Begin()

                ' Receive the message. 
                Dim myMessage As Message = _
                    myQueue.Receive(myTransaction)
                Dim myOrder As [String] = CType(myMessage.Body, _
                    [String])

                ' Display message information.
                Console.WriteLine(myOrder)

                ' Commit the transaction.
                myTransaction.Commit()


            Catch e As MessageQueueException

                ' Handle nontransactional queues.
                If e.MessageQueueErrorCode = _
                    MessageQueueErrorCode.TransactionUsage Then

                    Console.WriteLine("Queue is not transactional.")

                End If

                ' Else catch other sources of a MessageQueueException.


                ' Roll back the transaction.
                myTransaction.Abort()


                ' Catch other exceptions as necessary, such as 
                ' InvalidOperationException, thrown when the formatter
                ' cannot deserialize the message.

            End Try

            Return

        End Sub

End Class

注釈

パラメーターによって定義された内部トランザクション コンテキストを使用して、 パラメーターを obj 含むメッセージを、 によって MessageQueue参照されるトランザクション キューに送信するには、このオーバーロードを transaction 使用します。 キューに送信するオブジェクトには、 または 任意の Message マネージド オブジェクトを指定できます。 以外 Messageのオブジェクトを送信すると、オブジェクトがシリアル化され、メッセージの本文に挿入されます。

このオーバーロードを使用して非トランザクション キューにメッセージを送信する場合、メッセージは例外をスローせずに配信不能キューに送信される可能性があります。

を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先順位などを指定した場合、これらの値は、アプリケーションがキューに送信するときに、型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信すると、 に設定 Message されたプロパティ値が優先 DefaultPropertiesToSend され、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

MessageQueueTransaction はスレッドアパートメント対応であるため、アパートメントの状態が の場合、 STAトランザクションを複数のスレッドで使用することはできません。 Visual Basic では、メイン スレッドの状態が にSTA設定されるため、サブルーチンで をMTAThreadAttribute適用するMain必要があります。 適用しない場合、別のスレッドを使用してトランザクション メッセージを送信すると、MessageQueueException 例外がスローされます。 を適用する場合は MTAThreadAttribute 、次のフラグメントを使用します。

<System.MTAThreadAttribute>
 public sub Main()

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• DefaultPropertiesToSend
• Message
• MessageQueueTransaction
• Transactional
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()

Send(Object, MessageQueueTransactionType)

この MessageQueue で参照されるキューにオブジェクトを送信します。

public:
 void Send(System::Object ^ obj, System::Messaging::MessageQueueTransactionType transactionType);

public void Send (object obj, System.Messaging.MessageQueueTransactionType transactionType);

member this.Send : obj * System.Messaging.MessageQueueTransactionType -> unit

Public Sub Send (obj As Object, transactionType As MessageQueueTransactionType)

パラメーター

obj

Object

キューに送信するオブジェクト。

transactionType

MessageQueueTransactionType

メッセージと関連付けるトランザクション コンテキストの種類を示す、MessageQueueTransactionType 値の 1 つ。

例外

InvalidEnumArgumentException

transactionType パラメーターが、MessageQueueTransactionType メンバーの 1 つではありません。

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例は、Send(Object, MessageQueueTransactionType) の使用方法を示します。

// Connect to a transactional queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message^ msg = gcnew Message("Example Message Body");

// Send the message.
queue->Send(msg, MessageQueueTransactionType::Single);

queue->Close();

// Connect to a transactional queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message msg = new Message("Example Message Body");

// Send the message.
queue.Send(msg, MessageQueueTransactionType.Single);

注釈

パラメーターで定義されたトランザクション コンテキストを使用して、 パラメーターを obj 含むメッセージを によって MessageQueue参照されるキューに送信するには、このオーバーロードを transactionType 使用します。 メッセージの送信に使用するtransactionType外部トランザクション コンテキストがスレッドに既にアタッチされている場合は、 パラメーターに を指定Automaticします。 メッセージを 1 つの内部トランザクションとして送信するかどうかを指定 Single します。 非トランザクション スレッドにトランザクション メッセージを送信するかどうかを指定 None できます。

キューに送信するオブジェクトには、 または 任意の Message マネージド オブジェクトを指定できます。 以外 Messageのオブジェクトを送信すると、オブジェクトがシリアル化され、メッセージの本文に挿入されます。

を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先順位などを指定した場合、これらの値は、アプリケーションがキューに送信するときに、型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信すると、 に設定 Message されたプロパティ値が優先 DefaultPropertiesToSend され、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• MessageQueueTransactionType
• DefaultPropertiesToSend
• Message
• Transactional
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()

Send(Object, String)

この MessageQueue で参照される非トランザクション キューにオブジェクトを送信し、メッセージのラベルを指定します。

public:
 void Send(System::Object ^ obj, System::String ^ label);

public void Send (object obj, string label);

member this.Send : obj * string -> unit

Public Sub Send (obj As Object, label As String)

パラメーター

obj

Object

キューに送信するオブジェクト。

label

String

メッセージのラベル。

例外

ArgumentNullException

label パラメーターが null です。

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例は、Send(Object, String) の使用方法を示します。

// Connect to a queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

// Create a new message.
Message^ msg = gcnew Message("Example Message Body");

// Send the message.
queue->Send(msg, "Example Message Label");

queue->Close();

// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Create a new message.
Message msg = new Message("Example Message Body");

// Send the message.
queue.Send(msg, "Example Message Label");

注釈

パラメーターを含む obj メッセージを によって参照されるキューに送信するには、このオーバーロードを MessageQueue使用します。 このオーバーロードでは、メッセージを識別する文字列ラベルを指定できます。 キューに送信するオブジェクトには、、構造体、データ オブジェクト、または任意のマネージド オブジェクトを指定できます Message。 以外のオブジェクトを Message送信した場合、オブジェクトはシリアル化され、メッセージの本文に挿入されます。

メッセージ ラベルはメッセージ キュー ラベルとは異なりますが、どちらもアプリケーションに依存し、メッセージ キューに継承する意味はありません。

このオーバーロードを使用してトランザクション キューにメッセージを送信すると、メッセージは配信不能キューに送信されます。 メッセージを他のメッセージを含むトランザクションの一部にする場合は、 または MessageQueueTransactionType をパラメーターとして受け取るMessageQueueTransactionオーバーロードを使用します。

Pathメッセージを送信する前に、このMessageQueueインスタンスの プロパティを指定する必要があります。 を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先度などを指定した場合、これらの値は、アプリケーションがキューに送信するときに型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信する場合、 に Message 設定されたプロパティ値が優先 DefaultPropertiesToSend され、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接形式の名前	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• DefaultPropertiesToSend
• Message
• Label
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()

Send(Object, String, MessageQueueTransaction)

この MessageQueue で参照されるトランザクション キューにオブジェクトを送信し、メッセージのラベルを指定します。

public:
 void Send(System::Object ^ obj, System::String ^ label, System::Messaging::MessageQueueTransaction ^ transaction);

public void Send (object obj, string label, System.Messaging.MessageQueueTransaction transaction);

member this.Send : obj * string * System.Messaging.MessageQueueTransaction -> unit

Public Sub Send (obj As Object, label As String, transaction As MessageQueueTransaction)

パラメーター

obj

Object

キューに送信するオブジェクト。

label

String

メッセージのラベル。

transaction

MessageQueueTransaction

MessageQueueTransaction オブジェクト。

例外

ArgumentNullException

label パラメーターが null です。

または

transaction パラメーターが null です。

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キュー アプリケーションが、トランザクションの使用方法が間違っていることを示しました。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例は、Send(Object, String, MessageQueueTransaction) の使用方法を示します。

// Connect to a transactional queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message^ msg = gcnew Message("Example Message Body");

// Create a message queuing transaction.
MessageQueueTransaction^ transaction = gcnew MessageQueueTransaction();

try
{
    // Begin a transaction.
    transaction->Begin();

    // Send the message to the queue.
    queue->Send(msg, "Example Message Label", transaction);

    // Commit the transaction.
    transaction->Commit();
}
catch (Exception^ ex)
{
    // Cancel the transaction.
    transaction->Abort();

    // Propagate the exception.
    throw ex;
}
finally
{
    // Dispose of the transaction object.
    delete transaction;
    queue->Close();
}

// Connect to a transactional queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message msg = new Message("Example Message Body");

// Create a message queuing transaction.
MessageQueueTransaction transaction = new MessageQueueTransaction();

try
{
    // Begin a transaction.
    transaction.Begin();

    // Send the message to the queue.
    queue.Send(msg, "Example Message Label", transaction);

    // Commit the transaction.
    transaction.Commit();
}
catch(System.Exception e)
{
    // Cancel the transaction.
    transaction.Abort();

    // Propagate the exception.
    throw e;
}
finally
{
    // Dispose of the transaction object.
    transaction.Dispose();
}

注釈

パラメーターによって定義された内部トランザクション コンテキストを使用して、 パラメーターを obj 含むメッセージを によって MessageQueue参照されるトランザクション キューに送信するには、このオーバーロードを transaction 使用します。 このオーバーロードでは、メッセージを識別する文字列ラベルを指定できます。 キューに送信するオブジェクトには、、構造体、データ オブジェクト、または任意のマネージド オブジェクトを指定できます Message。 以外のオブジェクトを Message送信した場合、オブジェクトはシリアル化され、メッセージの本文に挿入されます。

メッセージ ラベルはメッセージ キュー ラベルとは異なりますが、どちらもアプリケーションに依存し、メッセージ キューに継承する意味はありません。

このオーバーロードを使用して非トランザクション キューにメッセージを送信する場合、メッセージは例外をスローせずに配信不能キューに送信される可能性があります。

を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先度などを指定した場合、これらの値は、アプリケーションがキューに送信するときに型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信する場合、 に Message 設定されたプロパティ値が優先 DefaultPropertiesToSend され、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

MessageQueueTransaction はスレッド アパートメント対応であるため、アパートメントの状態が の場合、 STA複数のスレッドでトランザクションを使用することはできません。 Visual Basic では、メイン スレッドの状態が にSTA設定されるため、 サブルーチンで をMTAThreadAttribute適用するMain必要があります。 適用しない場合、別のスレッドを使用してトランザクション メッセージを送信すると、MessageQueueException 例外がスローされます。 を適用する場合は MTAThreadAttribute 、次のフラグメントを使用します。

<System.MTAThreadAttribute>
 public sub Main()

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接形式の名前	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• DefaultPropertiesToSend
• Message
• MessageQueueTransaction
• Transactional
• Label
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()

Send(Object, String, MessageQueueTransactionType)

この MessageQueue で参照されるキューにオブジェクトを送信し、メッセージのラベルを指定します。

public:
 void Send(System::Object ^ obj, System::String ^ label, System::Messaging::MessageQueueTransactionType transactionType);

public void Send (object obj, string label, System.Messaging.MessageQueueTransactionType transactionType);

member this.Send : obj * string * System.Messaging.MessageQueueTransactionType -> unit

Public Sub Send (obj As Object, label As String, transactionType As MessageQueueTransactionType)

パラメーター

obj

Object

キューに送信するオブジェクト。

label

String

メッセージのラベル。

transactionType

MessageQueueTransactionType

メッセージと関連付けるトランザクション コンテキストの種類を示す、MessageQueueTransactionType 値の 1 つ。

例外

ArgumentNullException

label パラメーターが null です。

MessageQueueTransaction

メッセージ キュー アプリケーションが、トランザクションの使用方法が間違っていることを示しました。

InvalidEnumArgumentException

transactionType パラメーターが、MessageQueueTransactionType メンバーの 1 つではありません。

MessageQueueException

Path プロパティが設定されていません。

- または -

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例は、Send(Object, String, MessageQueueTransactionType) の使用方法を示します。

// Connect to a transactional queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message^ msg = gcnew Message("Example Message Body");

// Send the message.
queue->Send(msg, "Example Message Label",
    MessageQueueTransactionType::Single);

queue->Close();

// Connect to a transactional queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleTransQueue");

// Create a new message.
Message msg = new Message("Example Message Body");

// Send the message.
queue.Send(msg, "Example Message Label",
    MessageQueueTransactionType.Single);

注釈

パラメーターによって定義されたトランザクション コンテキストを使用して、 パラメーターを obj 含むメッセージを によって MessageQueue参照されるキューに送信するには、このオーバーロードを transactionType 使用します。 メッセージの送信に使用するtransactionTypeスレッドに外部トランザクション コンテキストが既にアタッチされている場合は、 パラメーターに を指定Automaticします。 メッセージを 1 つの内部トランザクションとして送信するかどうかを指定 Single します。 トランザクション 以外のスレッドにトランザクション メッセージを送信するかどうかを指定 None できます。

キューに送信するオブジェクトには、 または 任意の Message マネージド オブジェクトを指定できます。 以外のオブジェクトを Message送信した場合、オブジェクトはシリアル化され、メッセージの本文に挿入されます。 このオーバーロードでは、メッセージを識別する文字列ラベルを指定できます。

メッセージ ラベルはメッセージ キュー ラベルとは異なりますが、どちらもアプリケーションに依存し、メッセージ キューに継承する意味はありません。

を呼び出すSend(Object)前に プロパティをFormatter設定しない場合、フォーマッタの既定値は になりますXmlMessageFormatter。

プロパティは DefaultPropertiesToSend 、 以外のオブジェクトに Message適用されます。 メンバーを使用して DefaultPropertiesToSend ラベルや優先度などを指定した場合、これらの値は、アプリケーションがキューに送信するときに型 Message ではないオブジェクトを含むメッセージに適用されます。 を Message送信すると、 に Message 設定されたプロパティ値が よりも優先 DefaultPropertiesToSendされ、メッセージの Message.Formatter プロパティがキューの MessageQueue.Formatter プロパティよりも優先されます。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接形式の名前	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• MessageQueueTransactionType
• DefaultPropertiesToSend
• Message
• Transactional
• Label
• Peek()
• Receive()
• BeginPeek()
• BeginReceive()