System.Messaging Spazio dei nomi

Riferimento

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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:

GetPrivateQueuesByMachine(String) abilita il recupero delle code private in un computer.
GetPublicQueuesByCategory(Guid), GetPublicQueuesByLabel(String)e GetPublicQueuesByMachine(String) forniscono modi per recuperare le code pubbliche in base ai criteri comuni. Un overload di fornisce dettagli ancora più dettagliati per la selezione di GetPublicQueues code in base a un numero di criteri di ricerca.

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.

Condividi tramite