Procedura: inviare messaggi semplici

Aggiornamento: novembre 2007

L'utilizzo di un'istanza del componente MessageQueue consente di inviare messaggi semplici a una coda in due righe di codice. Quando si invia un messaggio semplice, è necessario effettuare le seguenti operazioni:

• Creare una connessione alla coda a cui si desidera inviare un messaggio.

• Specificare il formattatore appropriato per i dati che si desidera inviare. Il formattatore consente di controllare quale tipo di dati può essere inviato in un messaggio e la modalità di persistenza di tali dati. Nei casi semplici è possibile utilizzare il formattatore predefinito. Per ulteriori informazioni, vedere Serializzazione dei messaggi.

• Chiamare il metodo Send, passando l'oggetto da inviare.

Creazione di una connessione alla coda

Una volta scelta la coda con cui si desidera comunicare, è necessario creare un'istanza del componente MessageQueue che faccia riferimento alla coda da utilizzare. È possibile creare questo componente dalla Casella degli strumenti o da Esplora server nel progetto oppure utilizzando il costruttore MessageQueue.

Per creare una connessione alla coda con cui si desidera comunicare

1. Creare un'istanza del componente MessageQueue. Per ulteriori informazioni, vedere Procedura: creare istanze del componente MessageQueue.

2. Utilizzare la proprietà Path del componente per connettersi alla coda con cui si desidera comunicare mediante il percorso, il nome di formato o l'etichetta della coda.

   Nota:
   Se il componente è stato creato da Esplora server, la proprietà Path viene impostata automaticamente sul percorso della coda.

Specifica dei dati da inviare

Ciascun componente MessageQueue contiene una serie di proprietà predefinite applicate a tutti i messaggi inviati mediante tale componente, se non diversamente specificato in un singolo messaggio. Nello scenario più semplice è possibile inviare un messaggio semplice alla coda mediante le proprietà predefinite impostate per il componente. Per ulteriori informazioni su tali proprietà, vedere Proprietà predefinite dei messaggi.

Il metodo Send consente di specificare un messaggio e di inviarlo alla coda. In un messaggio semplice è possibile inviare oggetti, tipi di dati primitivi, flussi e altri tipi di dati.

Il componente MessageQueue accetta i dati immessi nell'argomento del metodo Send, li rende permanenti all'interno di un messaggio, quindi invia il messaggio alla coda specificata.

Nota:
È anche possibile utilizzare l'oggetto Message per inviare messaggi molto più complessi a una coda. È inoltre possibile inviare messaggi come parte di una transazione. Per ulteriori informazioni, vedere Procedura: inviare messaggi complessi.

Per inviare un messaggio semplice

• Nella finestra Proprietà del componente MessageQueue, accettare il valore predefinito per la proprietà Formatter oppure impostare la proprietà su XmlMessageFormatter, qualora sia stato modificato il valore predefinito.

  Utilizzare il metodo Send per inviare alla coda un messaggio semplice, specificando il messaggio come argomento del metodo.

  ' 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");
  

  Questo esempio di codice è anche disponibile come frammento di codice IntelliSense ed è presente nella casella di selezione dei frammenti di codice in Sistema operativo Windows > Code messaggi. Per ulteriori informazioni, vedere Procedura: inserire frammenti nel codice (Visual Basic).

Vedere anche

Attività

Procedura: creare istanze del componente MessageQueue

Procedura: inviare messaggi complessi

Procedura: verificare i messaggi in fase di progettazione

Concetti

Elaborazione transazionale dei messaggi

Altre risorse

Invio e serializzazione di messaggi