Esporta (0) Stampa
Espandi tutto
Espandi Riduci a icona

Spazio dei nomi System.Messaging

Aggiornamento: novembre 2007

Lo spazio dei nomi System.Messaging fornisce classi che consentono di connettersi, monitorare e amministrare le code di messaggi in rete e inviare, ricevere o leggere i messaggi.

I membri della classe MessageQueue includono i seguenti metodi per leggere e scrivere i messaggi nella coda:

  • Il metodo Send() consente all'applicazione di scrivere messaggi nella coda. Overload del metodo consentono di specificare se inviare il messaggio utilizzando un Message, che fornisce un controllo dettagliato sulle informazioni inviate, oppure un qualsiasi altro oggetto gestito, incluse le classi specifiche dell'applicazione. Il metodo supporta anche l'invio di messaggi come parte di una transazione.

  • I metodi Receive, ReceiveById() e ReceiveByCorrelationId() forniscono le funzionalità per leggere i messaggi da una coda. Anch'essi, analogamente al metodo Send(), forniscono overload che supportano l'elaborazione della coda transazionale e overload con parametri di timeout

    che consentono di continuare l'elaborazione qualora la coda sia vuota. Dato che questi metodi sono esempi di elaborazione sincrona, se non si specifica un timeout interrompono il thread corrente finché non è disponibile un messaggio.

  • Il metodo Peek è simile a Receive, ma non comporta la rimozione di un messaggio dalla coda quando viene letto. Dato che Peek non cambia il contenuto della coda, non esistono overload a supporto dell'elaborazione transazionale. Tuttavia, dato che Peek, come Receive, legge in modo sincrono i messaggi in coda, gli overload del metodo supportano la specifica di un timeout per evitare che il thread rimanga in attesa per un periodo di tempo indefinito.

  • I metodi BeginPeek, EndPeek(IAsyncResult), BeginReceive e EndReceive(IAsyncResult) forniscono dei modi di lettura asincrona dei messaggi dalla coda. Non interrompono il thread corrente in attesa che un messaggio arrivi nella coda.

I seguenti metodi della classe MessageQueue forniscono funzionalità per il recupero di elenchi di code in base ai criteri indicati e per determinare se esistono code specifiche:

Altri metodi della classe MessageQueue forniscono le seguenti funzionalità:

  • Creazione ed eliminazione di code di Accodamento messaggi.

  • Utilizzo di un enumeratore dei messaggi per scorrere i messaggi in una coda.

  • Utilizzo di un enumeratore delle code per l'iterazione sulle code del sistema.

  • Impostazione dei diritti di accesso basati su ACL.

  • Utilizzo della cache di connessioni.

La classe Message fornisce un controllo dettagliato sulle informazioni inviate in una coda ed è l'oggetto utilizzato quando si ricevono o leggono i messaggi da una coda. Oltre al corpo del messaggio, fra le proprietà della classe Message rientrano le impostazioni di conferma, la selezione del formattatore, le informazioni sull'identificazione, l'autenticazione e la crittografia, i timestamp, le indicazioni sull'utilizzo delle code di analisi, del diario del server e dei messaggi non consegnati e i dati di transazione.

Al componente MessageQueue sono associati i tre formattatori seguenti che consentono di serializzare e deserializzare i messaggi inviati e ricevuti dalle code:

  • Il formattatore XmlMessageFormatter fornisce messaggistica ad accoppiamento ridotto, consentendo versioni indipendenti dei tipi serializzati nel client e nel server.

  • Il formattatore ActiveXMessageFormatter è compatibile con il controllo COM di MSMQ. Consente di inviare i tipi che possono essere ricevuti dal controllo e di ricevere quelli inviati da esso.

  • Il formattatore BinaryMessageFormatter fornisce un'alternativa più rapida rispetto a XmlMessageFormatter, ma senza il vantaggio della messaggistica ad accoppiamento ridotto.

Altre classi nello spazio dei nomi Messaging supportano la protezione basata su ACL e per l'accesso ai codici, filtrando le proprietà Message al momento di leggere i messaggi da una coda e utilizzando le transazioni al momento di inviarli e riceverli.

  ClasseDescrizione
AccessControlEntrySpecifica i diritti di accesso di un fiduciario (utente, gruppo o computer) per eseguire implementazioni delle operazioni comuni specifiche dell'applicazione.
AccessControlListContiene un elenco di voci di controllo di accesso che specificano i diritti di accesso per uno o più fiduciari.
ActiveXMessageFormatterSerializza o deserializza i tipi di dati primitivi e altri oggetti nel o dal corpo di un messaggio di Accodamento messaggi, utilizzando un formato compatibile con il componente MSMQ ActiveX.
BinaryMessageFormatterSerializza o deserializza un oggetto o un intero grafico di oggetti collegati, nel o dal corpo di un messaggio di Accodamento messaggi, utilizzando un formato binario.
CursorUn oggetto Cursor viene uitlizzato per mantenere una posizione specifica in un oggetto MessageQueue durante la lettura dei messaggi della coda.
DefaultPropertiesToSendSpecifica i valori predefiniti delle proprietà che verranno utilizzati per l'invio di oggetti diversi da istanze Message a una coda di messaggi.
MessageFornisce accesso alle proprietà necessarie per definire un messaggio di Accodamento messaggi.
MessageEnumeratorFornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.
MessagePropertyFilterControlla e seleziona le proprietà recuperate durante la lettura o la ricezione di messaggi da una coda.
MessageQueue Fornisce l'accesso a una coda su un server di Accodamento messaggi.
MessageQueueAccessControlEntrySpecifica i diritti di accesso per un fiduciario (utente, gruppo o computer) per eseguire operazioni di Accodamento messaggi.
MessageQueueCriteriaFiltra le code dei messaggi durante l'esecuzione di una query, mediante il metodo GetPublicQueues della classe MessageQueue.
MessageQueueEnumeratorFornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.
MessageQueueExceptionEccezione generata quando viene rilevato un errore interno di Accodamento messaggi Microsoft.
MessageQueueInstallerConsente di installare e configurare una coda necessaria all'esecuzione dell'applicazione. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di un oggetto MessageQueue.
MessageQueuePermissionConsente di controllare le autorizzazioni di accesso al codice per la messaggistica.
MessageQueuePermissionAttributeConsente di controllare le autorizzazioni dichiarative MessageQueue.
MessageQueuePermissionEntryDefinisce l'unità più piccola di un'autorizzazione di protezione di accesso al codice per la messaggistica.
MessageQueuePermissionEntryCollectionContiene un insieme fortemente tipizzato di oggetti MessageQueuePermissionEntry.
MessageQueueTransactionFornisce una transazione interna di Accodamento messaggi.
MessagingDescriptionAttributeSpecifica una descrizione per una proprietà o un evento.
PeekCompletedEventArgsFornisce i dati per l'evento PeekCompleted. Quando l'operazione di visualizzazione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.
ReceiveCompletedEventArgsFornisce i dati per l'evento ReceiveCompleted. Quando l'operazione di ricezione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.
SecurityContextRappresenta il contesto di protezione di un messaggio della coda.
TrusteeSpecifica un account utente, un account di gruppo o la sessione di accesso a cui si applica una voce di controllo di accesso.
XmlMessageFormatterSerializza e deserializza oggetti nel e dal corpo di un messaggio, utilizzando il formato XML basato sulla definizione di schema XSD.

  InterfacciaDescrizione
IMessageFormatterSerializza o deserializza gli oggetti dal corpo di un messaggio di Accodamento messaggi.

  DelegatoDescrizione
PeekCompletedEventHandlerRappresenta il metodo che gestirà l'evento PeekCompleted di un oggetto MessageQueue.
ReceiveCompletedEventHandlerRappresenta il metodo che gestirà l'evento ReceiveCompleted di un oggetto MessageQueue.

  EnumerazioneDescrizione
AccessControlEntryTypeSpecifica se concedere, negare o revocare i diritti di accesso a un fiduciario.
AcknowledgeTypesSpecifica i tipi di messaggio di conferma che Accodamento messaggi restituisce all'applicazione mittente.
AcknowledgmentSpecifica il risultato del tentativo di consegna di un messaggio.
CryptographicProviderTypeSpecifica i provider del servizio di crittografia disponibili per la convalida delle firme digitali.
EncryptionAlgorithmSpecifica l'algoritmo utilizzato per crittografare il corpo di un messaggio privato.
EncryptionRequiredSpecifica il livello di riservatezza dei messaggi ricevuti dalla coda.
GenericAccessRightsUtilizza il formato di accesso di Windows 2000 e Windows NT per specificare un gruppo di diritti di accesso comuni che Accodamento messaggi mappa ai diritti di accesso sia standard che specifici dell'oggetto, per la lettura, la scrittura e l'esecuzione.
HashAlgorithmSpecifica l'algoritmo hash utilizzato da Accodamento messaggi in fase di autenticazione dei messaggi.
MessageLookupActionSpecifica un messaggio da leggere o ricevere da una coda messaggi.
MessagePrioritySpecifica la priorità che Accodamento messaggi applica a un messaggio durante l'instradamento a una coda e durante il suo inserimento nella coda di destinazione.
MessageQueueAccessRightsStabilisce un gruppo di diritti di accesso specifici dell'oggetto per operazioni che interessano Accodamento messaggi.
MessageQueueErrorCodeIdentifica l'origine di un errore verificatosi all'interno dell'applicazione Accodamento messaggi e che ha generato un'eccezione MessageQueueException.
MessageQueuePermissionAccessDefinisce i livelli di accesso utilizzati dalle classi di autorizzazione di System.Messaging.
MessageQueueTransactionStatusSpecifica lo stato di una transazione interna di Accodamento messaggi.
MessageQueueTransactionTypeSpecifica il tipo di una transazione di Accodamento messaggi.
MessageTypeIdentifica il tipo di messaggio, che può essere un tipico messaggio di Accodamento messaggi, un messaggio di conferma positivo o negativo (arrivo e lettura) oppure un messaggio di report.
PeekActionIndica se leggere il messaggio corrente in una coda oppure il messaggio successivo.
QueueAccessModeSpecifica la modalità di accesso per un oggetto MessageQueue al momento della creazione.
StandardAccessRightsSpecifica una serie di diritti di accesso standard che corrispondono alle operazioni comuni alla maggior parte dei tipi di oggetti proteggibili.
TrusteeTypeSpecifica il tipo di fiduciario.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft