System.Messaging Spazio dei nomi

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

Classi

Nome	Descrizione
AccessControlEntry	Specifica i diritti di accesso per un trustee (utente, gruppo o computer) per eseguire implementazioni specifiche dell'applicazione di attività comuni.
AccessControlList	Contiene un elenco di voci di controllo di accesso, specificando i diritti di accesso per uno o più trustee.
ActiveXMessageFormatter	Serializza o deserializza tipi di dati primitivi e altri oggetti da o verso il corpo di un messaggio di accodamento messaggi, utilizzando un formato compatibile con il componente ActiveX MSMQ.
BinaryMessageFormatter	Serializza o deserializza un oggetto o un intero grafico di oggetti connessi, da o verso il corpo di un messaggio di accodamento messaggi, utilizzando un formato binario.
Cursor	Un Cursor oggetto viene usato per mantenere una posizione specifica in un MessageQueue oggetto durante la lettura dei messaggi della coda.
DefaultPropertiesToSend	Specifica i valori di proprietà predefiniti che verranno utilizzati durante l'invio di oggetti diversi da Message istanze a una coda di messaggi.
Message	Fornisce l'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 visualizzazione o la ricezione di messaggi da una coda di messaggi.
MessageQueue	Fornisce l'accesso a una coda in un server di accodamento messaggi.
MessageQueueAccessControlEntry	Specifica i diritti di accesso per un trustee (utente, gruppo o computer) per eseguire attività di accodamento messaggi.
MessageQueueCriteria	Filtra le code dei messaggi durante l'esecuzione di una query usando il MessageQueue metodo della GetPublicQueues() classe .
MessageQueueEnumerator	Fornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.
MessageQueueException	Eccezione generata se si verifica un errore interno di Accodamento messaggi Microsoft.
MessageQueueInstaller	Consente di installare e configurare una coda necessaria per l'esecuzione dell'applicazione. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di .MessageQueue
MessageQueuePermission	Consente il controllo delle autorizzazioni di accesso al codice per la messaggistica.
MessageQueuePermissionAttribute	Consente controlli delle autorizzazioni dichiarative MessageQueue .
MessageQueuePermissionEntry	Definisce l'unità più piccola di un set di autorizzazioni di sicurezza per l'accesso al codice per la messaggistica.
MessageQueuePermissionEntryCollection	Contiene una raccolta fortemente tipizzata di MessageQueuePermissionEntry oggetti.
MessageQueueTransaction	Fornisce una transazione interna di accodamento messaggi.
MessagingDescriptionAttribute	Specifica una descrizione per una proprietà o un evento.
PeekCompletedEventArgs	Fornisce 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.
ReceiveCompletedEventArgs	Fornisce 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.
SecurityContext	Rappresenta il contesto di sicurezza per un messaggio in una coda.
Trustee	Specifica un account utente, un account di gruppo o una sessione di accesso a cui si applica una voce di controllo di accesso.
XmlMessageFormatter	Serializza e deserializza oggetti da o verso il corpo di un messaggio, utilizzando il formato XML basato sulla definizione dello schema XSD.

Interfacce

Nome	Descrizione
IMessageFormatter	Serializza o deserializza oggetti dal corpo di un messaggio di accodamento messaggi.

Enumerazioni

Nome	Descrizione
AccessControlEntryType	Specifica se consentire, negare o revocare i diritti di accesso per un trustee.
AcknowledgeTypes	Specifica i tipi di messaggio di riconoscimento restituiti dall'accodamento messaggi all'applicazione di invio.
Acknowledgment	Specifica il risultato di un tentativo di recapito dei messaggi.
CryptographicProviderType	Specifica i provider di servizi di crittografia disponibili per la convalida delle firme digitali.
EncryptionAlgorithm	Specifica l'algoritmo di crittografia utilizzato per crittografare il corpo del messaggio di un messaggio privato.
EncryptionRequired	Specifica il livello di privacy dei messaggi ricevuti dalla coda.
GenericAccessRights	Utilizza il formato di accesso Windows 2000 e Windows NT per specificare un set di diritti di accesso comuni mappati sia ai diritti di accesso standard che a diritti di accesso specifici dell'oggetto per la lettura, la scrittura e l'esecuzione.
HashAlgorithm	Specifica l'algoritmo hash utilizzato da Accodamento messaggi durante l'autenticazione dei messaggi.
MessageLookupAction	Specifica un messaggio da visualizzare o ricevere da una coda di messaggi.
MessagePriority	Specifica che l'accodamento messaggi con priorità si applica a un messaggio mentre è instradato a una coda e quando si inserisce il messaggio nella coda di destinazione.
MessageQueueAccessRights	Specifica un set di diritti di accesso specifici dell'oggetto per le operazioni specifiche di Accodamento messaggi.
MessageQueueErrorCode	Identifica l'origine di un errore che si è verificato all'interno dell'applicazione Accodamento messaggi e ha generato un'eccezione MessageQueueException.
MessageQueuePermissionAccess	Definisce i livelli di accesso usati 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 un messaggio. Un messaggio può essere un tipico messaggio di accodamento messaggi, un messaggio di riconoscimento positivo (arrivo e lettura) o negativo (arrivo e lettura) o un messaggio di segnalazione.
PeekAction	Indica se visualizzare il messaggio corrente in una coda o il messaggio successivo.
QueueAccessMode	Specifica la modalità di accesso per un MessageQueue in fase di creazione.
StandardAccessRights	Specifica un set di diritti di accesso standard che corrispondono alle operazioni comuni alla maggior parte dei tipi di oggetti a protezione diretta.
TrusteeType	Specifica il tipo di trustee.

Delegati

Nome	Descrizione
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 leggere e scrivere 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 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. Analogamente al Send metodo , questi metodi forniscono overload che supportano l'elaborazione transazionale della coda. 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 comporta 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, come Receive, legge i messaggi in modo sincrono dalla coda, gli overload del metodo supportano la specifica di un timeout per impedire che il thread sia in attesa illimitato.

• I BeginPeekmetodi , BeginReceiveEndPeek(IAsyncResult), e EndReceive(IAsyncResult) consentono di 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 recuperare elenchi di code in base ai criteri specificati e determinare 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 a criteri comuni. Un overload di GetPublicQueues fornisce dettagli ancora più dettagliati per la selezione delle code in base a diversi criteri di ricerca.

Altri metodi della MessageQueue classe forniscono le funzionalità seguenti:

• Creazione ed eliminazione di code di accodamento messaggi.

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

• Uso di un enumeratore di coda per scorrere le code nel sistema.

• Impostazione dei diritti di accesso basati su ACL.

• Utilizzo 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 Message 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 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 ad accoppiamento libero, abilitando il controllo delle versioni indipendenti 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 della messaggistica ad accoppiamento libero.

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