MessageQueueTransaction Clase

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Proporciona una transacción interna de Message Queuing.

public ref class MessageQueueTransaction : IDisposable

public class MessageQueueTransaction : IDisposable

type MessageQueueTransaction = class
    interface IDisposable

Public Class MessageQueueTransaction
Implements IDisposable

Herencia

Object

MessageQueueTransaction

Implementaciones

IDisposable

Comentarios

Para enviar o recibir un mensaje como parte de una transacción, puede usar la MessageQueueTransaction clase para crear una transacción y pasarla a una sobrecarga del MessageQueue.Send método o al MessageQueue.Receive método que toma un transaction parámetro. Los mensajes enviados como parte de una transacción deben enviarse a colas transaccionales. Los mensajes recibidos de las colas transaccionales deben recibirse mediante una transacción especificada.

Además del Receive método , puede recibir mensajes con un identificador especificado o un identificador de correlación especificado. Consulte los ReceiveById métodos y ReceiveByCorrelationId para obtener más información sobre la recepción selectiva de mensajes de colas transaccionales.

Los mensajes enviados a colas transaccionales se quitan si se confirma la transacción. Del mismo modo, los mensajes recibidos de las colas transaccionales se devuelven a la cola si la transacción se revierte.

Si crea una MessageQueueTransaction instancia de y la pasa a una sobrecarga aplicable del Send método o Receive método para enviar un mensaje a una cola no transaccional o recibir un mensaje de una cola no transaccional, el método produce una excepción que indica "Uso incorrecto de transacciones".

MessageQueueTransaction es consciente del contenedor de subprocesos, por lo que si el estado del apartamento es STA, no puede usar la transacción en varios subprocesos. Visual Basic establece el estado del subproceso STAprincipal en , por lo que debe aplicar en MTAThreadAttribute la Main subrutina. De lo contrario, al enviar un mensaje transaccional mediante otro subproceso se producirá una excepción MessageQueueException. Se aplica MTAThreadAttribute mediante el fragmento siguiente.

<System.MTAThreadAttribute>  
 public sub Main()  

Constructores

MessageQueueTransaction()

Inicializa una nueva instancia de la clase MessageQueueTransaction.

Propiedades

Status

Obtiene el estado de la transacción.

Métodos

Abort()	Deshace la transacción interna pendiente.
Begin()	Inicia una nueva transacción interna de Message Queuing.
Commit()	Confirma una transacción interna pendiente.
Dispose()	Libera todos los recursos que usa MessageQueueTransaction.
Dispose(Boolean)	Libera los recursos no administrados que usa MessageQueueTransaction y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Finalize()	Libera los recursos mantenidos por la instancia actual.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.

Consulte también

• Transactional
• Send(Object)