Cómo: Enviar mensajes simples

Actualización: noviembre 2007

Utilizando una instancia del componente MessageQueue, puede enviar mensajes simples a una cola con tan sólo dos líneas de código. Cuando envíe un mensaje simple, deberá ejecutar las siguientes acciones:

• Crear una conexión a la cola a la que desea enviar un mensaje.

• Especificar el formateador adecuado para los datos que desea enviar. El formateador controla el tipo de datos que se puede enviar en un mensaje y el modo de persistencia de los datos. En casos sencillos, el formateador predeterminado es aceptable. Para obtener más información, vea Serialización de mensajes.

• Llamar al método Send y transferir el objeto que se va a enviar.

Crear una conexión a la cola

Después de decidir con qué cola desea comunicarse, necesitará crear una instancia del componente MessageQueue que haga referencia a la cola que desea utilizar. Puede crear este componente desde el Cuadro de herramientas, desde el Explorador de servidores correspondiente al proyecto o mediante el constructor MessageQueue.

Para crear una conexión a la cola con la que desea comunicarse

1. Cree una instancia del componente MessageQueue. Para obtener más información, vea Cómo: Crear instancias de componentes MessageQueue.

2. Utilice la propiedad Path del componente para conectarse a la cola con la que desea comunicarse mediante la ruta de acceso a la cola, el nombre de formato o la etiqueta.

   Nota:
   Si ha creado el componente desde el Explorador de servidores, la propiedad Path se establecerá automáticamente en la ruta de acceso a dicha cola.

Proporcionar los datos que se van a enviar

Cada componente MessageQueue contiene una serie de propiedades predeterminadas que se aplican a todos los mensajes enviados por el componente, a menos que se especifique lo contrario en un mensaje individual. En el escenario más sencillo, puede enviar un mensaje simple a la cola mediante las propiedades predeterminadas establecidas para el componente. Para obtener más información sobre estas propiedades, vea Propiedades predeterminadas de los mensajes.

Utilice el método Send para especificar un mensaje y enviarlo a la cola. En un mensaje simple puede enviar objetos, tipos de datos primitivos, secuencias y otros tipos de datos.

El componente MessageQueue toma los datos que se especifican en el argumento del método Send, los guarda en un mensaje y envía el mensaje a la cola especificada.

Nota:
También puede utilizar el objeto Message para enviar mensajes mucho más complejos a una cola. Además, puede enviar mensajes como parte de una transacción. Para obtener más información, vea Cómo: Enviar mensajes complejos.

Para enviar un mensaje simple

• En la ventana Propiedades del componente MessageQueue, acepte el valor predeterminado de Formatter o establezca la propiedad en XmlMessageFormatter si ha modificado el valor predeterminado.

  Utilice el método Send para enviar un mensaje simple a la cola y especifique el mensaje como argumento del método.

  ' Create a connection to the queue.
  Dim MessageQueue1 As New System.Messaging.MessageQueue(".\YourQueue")
  ' Send an integer.
  MessageQueue1.Send(1)
  ' Send a string.
  MessageQueue1.Send("Hello world")
  

       // Create a connection to the queue.
          System.Messaging.MessageQueue mq =
             new System.Messaging.MessageQueue(@".\YourQueue");
          // Send an integer.
          mq.Send(1);
          // Send a string.
          mq.Send("Hello world");
  

  Este ejemplo de código también está disponible como fragmento de código de IntelliSense. En el selector de fragmentos de código, se encuentra en Sistema operativo Windows > Colas de mensajes. Para obtener más información, vea Cómo: Insertar fragmentos de código en el código (Visual Basic).

Vea también

Tareas

Cómo: Crear instancias de componentes MessageQueue

Cómo: Enviar mensajes complejos

Cómo: Comprobar mensajes en tiempo de diseño

Conceptos

Procesamiento transaccional de mensajes

Otros recursos

Enviar y serializar mensajes