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 フィルター処理、メッセージの送受信時のトランザクションの使用がサポートされています。

System.Messaging 名前空間

クラス

インターフェイス

列挙型

代理人

注釈

フィードバック

その他のリソース