次の方法で共有

MessageQueue.Send メソッド (Object, String)

  • [アーティクル]

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

Overloads Public Sub Send( _
   ByVal obj As Object, _   ByVal label As String _)
[C#]
public void Send(objectobj,stringlabel);
[C++]
public: void Send(Object* obj,String* label);
[JScript]
public function Send(
   obj : Object,label : String);

パラメータ

  • obj
    キューに送信するオブジェクト。
  • label
    メッセージのラベル。

例外

例外の種類 条件
ArgumentNullException label パラメータが null 参照 (Visual Basic では Nothing) です。
MessageQueueException Path プロパティが設定されていません。

または

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

解説

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

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

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

この MessageQueue インスタンスの Path プロパティは、メッセージを送信する前に指定する必要があります。 Send を呼び出す前に Formatter プロパティを設定しないと、書式指定子が既定の XmlMessageFormatter に設定されます。

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

このメソッドが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード 使用可否
ローカル コンピュータ はい
ローカル コンピュータ + 直接書式名 はい
リモート コンピュータ いいえ
リモート コンピュータ + 直接書式名 はい

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

MessageQueue クラス | MessageQueue メンバ | System.Messaging 名前空間 | MessageQueue.Send オーバーロードの一覧 | DefaultPropertiesToSend | Message | Label | Peek | Receive | BeginPeek | BeginReceive