System.Messaging 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ネットワークのメッセージ キューへの接続、監視、および管理を行い、メッセージの送信、受信、またはピークを行うことができるクラスを提供します。
クラス
| AccessControlEntry |
共通タスクのアプリケーション固有の実装を行うトラスティ (ユーザー、グループ、またはコンピューター) のアクセス権を指定します。 |
| AccessControlList |
1 つ以上のトラスティのアクセス権を指定したアクセス制御エントリのリストを格納しています。 |
| ActiveXMessageFormatter |
MSMQ ActiveX コンポーネントと互換性のある形式を使用して、メッセージ キュー メッセージの本文との間でプリミティブ データ型と他のオブジェクトのシリアル化または逆シリアル化を行います。 |
| BinaryMessageFormatter |
バイナリ形式を使用して、メッセージ キューのメッセージの本文との間でオブジェクトまたは関連付けられたオブジェクトのグラフ全体のシリアル化または逆シリアル化を行います。 |
| Cursor |
Cursor は、キューのメッセージを読み取るときに、MessageQueue 内の特定の場所を維持するために使用されます。 |
| DefaultPropertiesToSend |
Message インスタンス以外のオブジェクトをメッセージ キューに送信するときに使われるプロパティの既定値を指定します。 |
| Message |
メッセージ キューのメッセージを定義するのに必要なプロパティへのアクセスを実現します。 |
| MessageEnumerator |
メッセージ キュー内のメッセージを列挙するための順方向専用カーソルを提供します。 |
| MessagePropertyFilter |
メッセージ キューからメッセージをピークまたは受信するときに取得されるプロパティを制御および選択します。 |
| MessageQueue |
メッセージ キュー サーバーのキューにアクセスできるようにします。 |
| MessageQueueAccessControlEntry |
メッセージ キューのタスクを実行するトラスティ (ユーザー、グループ、またはコンピューター) のアクセス権を指定します。 |
| MessageQueueCriteria |
MessageQueue クラスの GetPublicQueues() メソッドを使用してクエリを実行するときに、メッセージ キューにフィルターをかけます。 |
| MessageQueueEnumerator |
メッセージ キュー内のメッセージを列挙するための順方向専用カーソルを提供します。 |
| MessageQueueException |
Microsoft Message Queuing の内部エラーが発生した場合にスローされる例外。 |
| MessageQueueInstaller |
アプリケーションの実行に必要なキューのインストールと構成ができます。 このクラスは、MessageQueue をインストールするときに、InstallUtil.exe などのインストール ユーティリティによって呼び出されます。 |
| MessageQueuePermission |
メッセージのコード アクセス許可を制御できるようにします。 |
| MessageQueuePermissionAttribute |
宣言 MessageQueue のアクセス許可をチェックできるようにします。 |
| MessageQueuePermissionEntry |
メッセージのためのコード アクセス セキュリティのアクセス許可セットの最小単位を定義します。 |
| MessageQueuePermissionEntryCollection |
MessageQueuePermissionEntry オブジェクトの厳密に型指定されたコレクションを格納します。 |
| MessageQueueTransaction |
メッセージ キューの内部トランザクションを提供します。 |
| MessagingDescriptionAttribute |
プロパティまたはイベントの説明文を指定します。 |
| PeekCompletedEventArgs |
PeekCompleted イベントのデータを提供します。 非同期のピーク操作がイベント ハンドラーを呼び出すと、そのクラスのインスタンスがハンドラーに渡されます。 |
| ReceiveCompletedEventArgs |
ReceiveCompleted イベントのデータを提供します。 非同期の受信操作がイベント ハンドラーを呼び出すと、このクラスのインスタンスがハンドラーに渡されます。 |
| SecurityContext |
キュー内のメッセージのセキュリティ コンテキストを表します。 |
| Trustee |
アクセス制御エントリの適用先のユーザー アカウント、グループ アカウント、またはログオン セッションを指定します。 |
| XmlMessageFormatter |
XSD スキーマ定義の XML 書式を使用して、メッセージ本文との間でオブジェクトをシリアル化および逆シリアル化します。 |
インターフェイス
| IMessageFormatter |
メッセージ キューのメッセージの本文からオブジェクトをシリアル化または逆シリアル化します。 |
列挙型
| AccessControlEntryType |
トラスティのアクセス権の許可、拒否、または取り消しを行うかどうかを指定します。 |
| AcknowledgeTypes |
メッセージ キューが送信元アプリケーションに返す受信確認メッセージのタイプを指定します。 |
| Acknowledgment |
試行されたメッセージ配信の結果を指定します。 |
| CryptographicProviderType |
デジタル署名の検証に使用できる暗号サービス プロバイダーを指定します。 |
| EncryptionAlgorithm |
プライベート メッセージの本文を暗号化するために使われる暗号化アルゴリズムを指定します。 |
| EncryptionRequired |
キューによって受信されたメッセージのプライバシ レベルを指定します。 |
| GenericAccessRights |
Windows 2000 および Windows NT のアクセス形式を使用して、メッセージ キューによって、読み取り、書き込み、および実行のための標準アクセス権とオブジェクト固有のアクセス権の両方に割り当てられる、共通アクセス権のセットを指定します。 |
| HashAlgorithm |
メッセージを認証するときにメッセージ キューで使用するハッシュ アルゴリズムを指定します。 |
| MessageLookupAction |
メッセージ キューからピークまたは受信するメッセージを指定します。 |
| MessagePriority |
メッセージがキューへ送信されている間、およびメッセージを送信先キューに挿入するときに、メッセージ キューによってメッセージに適用される優先順位を指定します。 |
| MessageQueueAccessRights |
メッセージ キュー固有の操作のためのオブジェクト固有のアクセス権のセットを指定します。 |
| MessageQueueErrorCode |
メッセージ キュー アプリケーション内で発生した、MessageQueueException 例外を生成したエラーの原因を識別します。 |
| MessageQueuePermissionAccess |
System.Messaging アクセス許可クラスによって使用されるアクセス レベルを定義します。 |
| MessageQueueTransactionStatus |
内部メッセージ キュー トランザクションの状態を指定します。 |
| MessageQueueTransactionType |
メッセージ キュー トランザクションのタイプを指定します。 |
| MessageType |
メッセージのタイプを識別します。 使用できるメッセージのタイプとして、通常のメッセージ キューのメッセージ、肯定受信確認メッセージ (到着および読み取り) または否定受信確認メッセージ (到着および読み取り)、レポート メッセージがあります。 |
| PeekAction |
キュー内の現在のメッセージまたは次のメッセージのどちらをピークするかを示します。 |
| QueueAccessMode |
MessageQueue のアクセス モードを作成時に指定します。 |
| StandardAccessRights |
セキュリティ設定できるオブジェクトのほとんどの型に共通する操作に対応する標準アクセス権のセットを指定します。 |
| TrusteeType |
トラスティの型を指定します。 |
代理人
| PeekCompletedEventHandler |
PeekCompleted の MessageQueue イベントを処理するメソッドを表します。 |
| ReceiveCompletedEventHandler |
ReceiveCompleted の MessageQueue イベントを処理するメソッドを表します。 |
注釈
クラスのメンバーには、 MessageQueue キューへのメッセージの読み取りと書き込みを行う次のメソッドが含まれます。
Sendメソッドを使用すると、アプリケーションでキューにメッセージを書き込みます。 メソッドのオーバーロードを使用すると、 (送信する情報の詳細な制御を提供する) またはアプリケーション固有のクラスを含む他のマネージド オブジェクトを使用して Message メッセージを送信するかどうかを指定できます。 メソッドでは、トランザクションの一部としてのメッセージの送信もサポートされています。
、ReceiveById、および ReceiveByCorrelationId メソッドはReceive、キューからメッセージを読み取るための機能を提供します。 メソッドと同様に Send 、これらのメソッドはトランザクション キュー処理をサポートするオーバーロードを提供します。 これらのメソッドは、タイムアウトを伴うオーバーロードも提供します。
キューが空の場合に処理を続行できるようにする出力パラメーター。 これらのメソッドは同期処理の例であるため、タイムアウトを指定しない限り、メッセージが使用可能になるまで現在のスレッドを中断します。
メソッドは Peek に Receive似ていますが、読み取り時にメッセージがキューから削除されることはありません。 キューの内容は変更されないため Peek 、トランザクション処理をサポートするオーバーロードはありません。 ただし、 のようにReceive、キューからメッセージを同期的に読み取るためPeek、メソッドのオーバーロードでは、スレッドが無期限に待機するのを防ぐためにタイムアウトの指定がサポートされます。
、EndPeek(IAsyncResult)、BeginReceiveおよび EndReceive(IAsyncResult) の各メソッドはBeginPeek、キューからメッセージを非同期的に読み取る方法を提供します。 メッセージがキューに到着するのを待っている間は、現在のスレッドを中断しません。
クラスの次の MessageQueue メソッドは、指定された条件によってキューのリストを取得し、特定のキューが存在するかどうかを判断する機能を提供します。
GetPrivateQueuesByMachine(String) を使用すると、コンピューター上のプライベート キューを取得できます。
GetPublicQueuesByCategory(Guid)、 GetPublicQueuesByLabel(String)、および は、 GetPublicQueuesByMachine(String) 一般的な条件でパブリック キューを取得する方法を提供します。 のオーバーロードでは、多数の GetPublicQueues 検索条件に基づいてキューを選択するためのさらに詳細な情報が提供されます。
クラスの他のメソッドには MessageQueue 、次の機能があります。
メッセージ キューキューの作成と削除。
メッセージ列挙子を使用してキュー内のメッセージをステップ実行する。
システム上のキューを反復処理するためのキュー列挙子の使用。
ACL ベースのアクセス権の設定。
接続キャッシュの操作。
クラスは Message 、キューに送信する情報を詳細に制御し、キューからメッセージを受信またはピークするときに使用されるオブジェクトです。 メッセージ本文の他に、クラスのプロパティには、受信確認の設定、フォーマッタの Message 選択、識別、認証と暗号化の情報、タイムスタンプ、トレース、サーバー ジャーナリング、配信不能キューの使用に関する表示、トランザクション データが含まれます。
コンポーネントは MessageQueue 次の 3 つのフォーマッタに関連付けられています。これにより、キューから送受信されるメッセージをシリアル化および逆シリアル化できます。
は XmlMessageFormatter 疎結合メッセージングを提供し、クライアントとサーバーでシリアル化された型の独立したバージョン管理を可能にします。
ActiveXMessageFormatterは MSMQ COM コントロールと互換性があります。 コントロールで受信できる型を送信したり、コントロールによって送信された型を受信したりできます。
は BinaryMessageFormatter 、 に対する XmlMessageFormatterより高速な代替手段を提供しますが、疎結合メッセージングの利点はありません。
名前空間の他の Messaging クラスでは、コード アクセスと ACL ベースのセキュリティ、キューからのメッセージの読み取り時のプロパティの Message フィルター処理、メッセージの送受信時のトランザクションの使用がサポートされています。
.NET