Message.Acknowledgment プロパティ

.NET Framework クラス ライブラリ リファレンス

Message.Acknowledgment プロパティ

そのメッセージが表す受信確認の分類を取得します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Acknowledgment As Acknowledgment

Visual Basic (使用法)

Dim instance As Message
Dim value As Acknowledgment

value = instance.Acknowledgment

C#

public Acknowledgment Acknowledgment { get;
 }

C++

public:
property Acknowledgment Acknowledgment {
    Acknowledgment get ();
}

J#

/** @property */
public Acknowledgment get_Acknowledgment ()

JScript

public function get Acknowledgment
 () : Acknowledgment

プロパティ値
Acknowledgment 列挙値の 1 つ。

例外

例外の種類	条件
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。 または フィルタ処理されたメッセージ キューが、Acknowledgment プロパティを無視します。

解説

管理キューからメッセージを受信するときは、Acknowledgment プロパティを読み取ることで元のメッセージのステータスを確認します。

メッセージが送信先キューに送信されるときに、受信確認メッセージをポストするようにメッセージ キューに要求できます。受信確認メッセージは、指定されたタイムアウト前にメッセージが到達および取得されたかどうかや、配信に失敗した場合の原因などを示すことができます。送信先キューは受信確認メッセージを返し、元のメッセージの AdministrationQueue プロパティに指定されている管理キューにそれらのメッセージをポストします。受信確認メッセージの Id プロパティは、元のメッセージではなく受信確認メッセージを識別します。元のメッセージの ID は、受信確認 Message インスタンスの CorrelationId プロパティの中に格納されます。

この Message インスタンスが受信確認メッセージを表すときは、Acknowledgment プロパティは受信確認のタイプを指定します。受信確認メッセージを表さないときは、Acknowledgment プロパティの値は Normal です。

受信確認を返す条件を指定するには、元のメッセージの AcknowledgeType プロパティを使います。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.AcknowledgeType プロパティ
AdministrationQueue
CorrelationId
PeekById
PeekByCorrelationId
ReceiveById
ReceiveByCorrelationId