Message.IsLastInTransaction プロパティ

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

Message.IsLastInTransaction プロパティ

メッセージがトランザクションで送信された最後のメッセージかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsLastInTransaction As Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.IsLastInTransaction

C#

public bool IsLastInTransaction { get;
 }

C++

public:
property bool IsLastInTransaction {
    bool get ();
}

J#

/** @property */
public boolean get_IsLastInTransaction ()

JScript

public function get IsLastInTransaction
 () : boolean

プロパティ値
そのメッセージがトランザクションで送信された最後のメッセージである場合は true。それ以外の場合は false。

例外

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

解説

受信側アプリケーションは、そのメッセージが 1 つのトランザクションで 1 つのキューに送信された最後のメッセージかどうかを IsLastInTransaction プロパティを使って確認します。

このプロパティは、メッセージ キュー Version 2.0 以降でだけ使用できます。

トランザクションの境界を確認するために IsLastInTransaction プロパティと共に使用できるプロパティは、IsFirstInTransaction と TransactionId です。前者はメッセージがトランザクションで送信された最初のメッセージかどうかを確認するために使用し、後者はトランザクションの ID を取得するために使用します。

トランザクション内で送信されたメッセージが 1 つだけであるときは、IsFirstInTransaction プロパティと IsLastInTransaction プロパティは、どちらも true に設定されます。

使用例

メッセージの IsLastInTransaction プロパティの値を表示するコード例を次に示します。

C#

// Display the value of the message's IsLastInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsLastInTransaction property must be set
// to true before the message is received.
Console.WriteLine("Message.IsLastInTransaction: {0}",
    orderMessage.IsLastInTransaction);

C++

// Display the value of the message's IsLastInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsLastInTransaction property must be set
// to true before the message is received.
Console::WriteLine("Message.IsLastInTransaction: {0}",
    orderMessage->IsLastInTransaction);

J#

// Display the value of the message's IsLastInTransaction property.
// To view this property value, the queue's
// MessageReadPropertyFilter.IsLastInTransaction property must be set
// to true before the message is received.
Console.WriteLine("Message.IsLastInTransaction: {0}", 
    System.Convert.ToString(orderMessage.get_IsLastInTransaction()));

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, 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.IsFirstInTransaction プロパティ
TransactionId
Transactional