System.Messaging Spazio dei nomi

Fornisce classi che consentono di connettersi, monitorare e amministrare le code di messaggi nella rete e inviare, ricevere o leggere i messaggi.

Classi

AccessControlEntry

Specifica i diritti di accesso di un fiduciario (utente, gruppo o computer) per eseguire implementazioni delle attività comuni specifiche dell'applicazione.

AccessControlList

Contiene un elenco di voci di controllo di accesso, specificando i diritti di accesso per uno o più trustee.

ActiveXMessageFormatter

Serializza 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.

BinaryMessageFormatter

Serializza 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.

Cursor

Un oggetto Cursor viene uitlizzato per mantenere una posizione specifica in un oggetto MessageQueue durante la lettura dei messaggi della coda.

DefaultPropertiesToSend

Specifica i valori predefiniti delle proprietà che verranno utilizzati per l'invio di oggetti diversi da istanze Message a una coda di messaggi.

Message

Fornisce accesso alle proprietà necessarie per definire un messaggio di Accodamento messaggi.

MessageEnumerator

Fornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.

MessagePropertyFilter

Controlla 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.

MessageQueueAccessControlEntry

Specifica i diritti di accesso per un fiduciario (utente, gruppo o computer) per eseguire attività di Accodamento messaggi.

MessageQueueCriteria

Filtra le code dei messaggi durante l'esecuzione di una query, mediante il metodo MessageQueue della classe GetPublicQueues().

MessageQueueEnumerator

Fornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.

MessageQueueException

Eccezione generata quando si verifica un errore interno di Servizi Accodamento messaggi Microsoft.

MessageQueueInstaller

Consente 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.

MessageQueuePermission

Consente di controllare le autorizzazioni di accesso al codice per la messaggistica.

MessageQueuePermissionAttribute

Consente di controllare le autorizzazioni dichiarative MessageQueue.

MessageQueuePermissionEntry

Definisce l'unità più piccola di un'autorizzazione di sicurezza per l'accesso al codice per la messaggistica.

MessageQueuePermissionEntryCollection

Contiene una raccolta fortemente tipizzata di oggetti MessageQueuePermissionEntry.

MessageQueueTransaction

Fornisce una transazione interna di Accodamento messaggi.

MessagingDescriptionAttribute

Specifica una descrizione per una proprietà o un evento.

PeekCompletedEventArgs

Fornisce dati per l'evento PeekCompleted. Quando l'operazione di visualizzazione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.

ReceiveCompletedEventArgs

Fornisce dati per l'evento ReceiveCompleted. Quando l'operazione di ricezione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.

SecurityContext

Rappresenta il contesto di sicurezza di un messaggio della coda.

Trustee

Specifica un account utente, un account di gruppo o la sessione di accesso a cui si applica una voce di controllo di accesso.

XmlMessageFormatter

Serializza e deserializza oggetti nel e dal corpo di un messaggio, utilizzando il formato XML basato sulla definizione di schema XSD.

Interfacce

IMessageFormatter

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

Enumerazioni

AccessControlEntryType

Specifica se concedere, negare o revocare i diritti di accesso a un fiduciario.

AcknowledgeTypes

Specifica i tipi di messaggio di conferma che Accodamento messaggi restituisce all'applicazione mittente.

Acknowledgment

Specifica il risultato del tentativo di consegna di un messaggio.

CryptographicProviderType

Specifica i provider del servizio di crittografia disponibili per la convalida delle firme digitali.

EncryptionAlgorithm

Specifica l'algoritmo utilizzato per crittografare il corpo di un messaggio privato.

EncryptionRequired

Specifica il livello di riservatezza dei messaggi ricevuti dalla coda.

GenericAccessRights

Utilizza 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.

HashAlgorithm

Specifica l'algoritmo hash usato da Accodamento messaggi per l'autenticazione dei messaggi.

MessageLookupAction

Specifica un messaggio da leggere o ricevere da una coda messaggi.

MessagePriority

Specifica la priorità che Accodamento messaggi applica a un messaggio durante l'instradamento a una coda e durante il suo inserimento nella coda di destinazione.

MessageQueueAccessRights

Stabilisce un gruppo di diritti di accesso specifici dell'oggetto per operazioni che interessano Accodamento messaggi.

MessageQueueErrorCode

Identifica l'origine di un errore verificatosi all'interno dell'applicazione Accodamento messaggi e che ha generato un'eccezione MessageQueueException.

MessageQueuePermissionAccess

Definisce i livelli di accesso utilizzati dalle classi di autorizzazione System.Messaging.

MessageQueueTransactionStatus

Specifica lo stato di una transazione interna di Accodamento messaggi.

MessageQueueTransactionType

Specifica il tipo di una transazione di Accodamento messaggi.

MessageType

Identifica 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.

PeekAction

Indica se leggere il messaggio corrente in una coda oppure il messaggio successivo.

QueueAccessMode

Specifica la modalità di accesso per un oggetto MessageQueue al momento della creazione.

StandardAccessRights

Specifica una serie di diritti di accesso standard che corrispondono alle operazioni comuni alla maggior parte dei tipi di oggetti proteggibili.

TrusteeType

Specifica il tipo di fiduciario.

Delegati

PeekCompletedEventHandler

Rappresenta il metodo che gestirà l'evento PeekCompleted di un oggetto MessageQueue.

ReceiveCompletedEventHandler

Rappresenta il metodo che gestirà l'evento ReceiveCompleted di un oggetto MessageQueue.

Commenti

I membri della MessageQueue classe includono i metodi seguenti per la lettura e la scrittura di messaggi nella coda:

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

  • I Receivemetodi , ReceiveByIde ReceiveByCorrelationId forniscono funzionalità per la lettura dei messaggi da una coda. Come il metodo, questi metodi forniscono overload che supportano l'elaborazione Send della coda transazionale. Questi metodi forniscono anche overload con timeout.

    Parametri out che consentono l'elaborazione per continuare se la coda è vuota. Poiché questi metodi sono esempi di elaborazione sincrona, interrompono il thread corrente fino a quando non è disponibile un messaggio, a meno che non si specifichi un timeout.

  • Il Peek metodo è simile a Receive, ma non causa la rimozione di un messaggio dalla coda quando viene letto. Poiché Peek non modifica il contenuto della coda, non sono presenti overload per supportare l'elaborazione transazionale. Tuttavia, poiché Peek, ad esempio Receive, legge i messaggi in modo sincrono dalla coda, gli overload del metodo supportano la specifica di un timeout per impedire al thread di attendere indefinito.

  • I BeginPeekmetodi , EndPeek(IAsyncResult), BeginReceivee EndReceive(IAsyncResult) forniscono modi per leggere in modo asincrono i messaggi dalla coda. Non interrompono il thread corrente durante l'attesa dell'arrivo di un messaggio nella coda.

I metodi seguenti della MessageQueue classe forniscono funzionalità per il recupero di elenchi di code tramite criteri specificati e determinando se esistono code specifiche:

Altri metodi della MessageQueue classe forniscono le funzionalità seguenti:

  • Creazione ed eliminazione di code di messaggi.

  • Uso di un enumeratore di messaggi per eseguire il passaggio dei messaggi in una coda.

  • Uso di un enumeratore della coda per l'iterazione delle code nel sistema.

  • Impostazione dei diritti di accesso basati su ACL.

  • Uso della cache di connessione.

La Message classe fornisce un controllo dettagliato sulle informazioni inviate a una coda ed è l'oggetto usato durante la ricezione o la visualizzazione di messaggi da una coda. Oltre al corpo del messaggio, le proprietà della classe includono le impostazioni di riconoscimento, la selezione del formattatore, l'identificazione, l'autenticazione e le informazioni di crittografia, i timestamp, le indicazioni sull'uso della Message traccia, il journaling del server e le code di messaggi non recapitabili e i dati delle transazioni.

Il MessageQueue componente è associato ai tre formattatori seguenti, che consentono di serializzare e deserializzare i messaggi inviati e ricevuti dalle code:

  • Fornisce XmlMessageFormatter la messaggistica associato in modo libero, consentendo il controllo indipendente delle versioni dei tipi serializzati nel client e nel server.

  • È ActiveXMessageFormatter compatibile con il controllo COM MSMQ. Consente di inviare tipi che possono essere ricevuti dal controllo e di ricevere tipi inviati dal controllo.

  • Offre BinaryMessageFormatter un'alternativa più veloce a XmlMessageFormatter, ma senza il vantaggio di messaggistica in modo libero.

Altre classi nello spazio dei nomi supportano la sicurezza basata su codice e ACL, filtrando Message le proprietà durante la lettura dei messaggi da una coda e l'uso delle transazioni durante l'invio Messaging e la ricezione di messaggi.