Message.IsFirstInTransaction Propiedad

Definición

Obtiene un valor que indica si el mensaje era el primer mensaje enviado en una transacción.Gets a value that indicates whether the message was the first message sent in a transaction.

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

Valor de propiedad

Boolean

true si el mensaje fue el primer mensaje enviado en una transacción; en cualquier otro caso, false.true if the message was the first message sent in a transaction; otherwise, false.

Atributos

Excepciones

El mensaje no se ha enviado.The message has not been sent. Esta propiedad solo puede leerse en mensajes recuperados de una cola.This property can only be read on messages retrieved from a queue.

o bien-or- La cola de mensajes se filtra para omitir la propiedad IsFirstInTransaction.The message queue is filtered to ignore the IsFirstInTransaction property.

Ejemplos

En el ejemplo de código siguiente se muestra el valor de la propiedad de un mensaje IsFirstInTransaction .The following code example displays the value of a message's IsFirstInTransaction property.

Comentarios

Las aplicaciones de recepción utilizan la IsFirstInTransaction propiedad para comprobar que un mensaje fue el primer mensaje enviado en una sola transacción a una sola cola.Receiving applications use the IsFirstInTransaction property to verify that a message was the first message sent in a single transaction to a single queue.

Esta propiedad solo está disponible con la versión 2,0 y posteriores de Message Queue Server.This property is available only with Message Queuing version 2.0 and later.

Para comprobar los límites de la transacción, puede usar la IsFirstInTransaction propiedad junto con otras dos propiedades: IsLastInTransaction y TransactionId .To verify transaction boundaries, you can use the IsFirstInTransaction property along with two other properties: IsLastInTransaction and TransactionId. Use el primero para comprobar si un mensaje era el último mensaje enviado en la transacción y use el último para recuperar el identificador de la transacción.Use the former to check whether a message was the last message sent in the transaction, and use the latter to retrieve the identifier of the transaction.

Si solo se envía un mensaje en una transacción, las IsFirstInTransaction IsLastInTransaction propiedades y se establecen en true .If only one message is sent in a transaction, the IsFirstInTransaction and IsLastInTransaction properties are both set to true.

Se aplica a

Consulte también