Message.IsFirstInTransaction 属性

定义

获取一个值,该值指示消息是否是事务中发送的第一条消息。

public:
 property bool IsFirstInTransaction { bool get(); };
[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }
[<System.Messaging.MessagingDescription("MsgIsFirstInTransaction")>]
member this.IsFirstInTransaction : bool
Public ReadOnly Property IsFirstInTransaction As Boolean

属性值

如果消息是事务中发送的第一条消息,则为 true;否则为 false

属性

例外

消息尚未发送。 该属性只能在从队列中检索的消息上读取。

- 或 -

消息队列经过筛选后忽略了 IsFirstInTransaction 属性。

示例

下面的代码示例显示消息的 IsFirstInTransaction 属性的值。

注解

接收应用程序使用 IsFirstInTransaction 属性来验证消息是否是单个事务中发送到单个队列的第一条消息。

此属性仅适用于消息队列 2.0 及更高版本。

若要验证事务边界,可以将 属性与两个其他属性一 IsFirstInTransaction 起使用: IsLastInTransactionTransactionId。 使用前者检查消息是否是事务中发送的最后一条消息,并使用后者检索事务的标识符。

如果在事务中只发送一条消息,则 IsFirstInTransactionIsLastInTransaction 属性都设置为 true

适用于

另请参阅