Message.IsFirstInTransaction 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

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

Boolean

如果消息是事务中发送的第一条消息，则为 true；否则为 false。

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

- 或 -

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

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

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

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

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

如果在事务中只发送一条消息，则 IsFirstInTransaction 和 IsLastInTransaction 属性都设置为 true。