System.Messaging Namespace

Lo spazio dei nomi System.Messaging fornisce classi che consentono di connettersi a, monitorare e amministrare le code di messaggi nella rete e inviare, ricevere o leggere i messaggi. The System.Messaging namespace provides classes that allow you to connect to, monitor, and administer message queues on the network and send, receive, or peek messages.

Classi

AccessControlEntry

Specifica i diritti di accesso di un fiduciario (utente, gruppo o computer) per eseguire implementazioni delle attività comuni specifiche dell'applicazione.Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

AccessControlList

Contiene un elenco di voci di controllo di accesso, specificando i diritti di accesso per uno o più trustee.Contains a list of access control entries, specifying access rights for one or more trustees.

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.Serializes or deserializes primitive data types and other objects to or from the body of a Message Queuing message, using a format that is compatible with the MSMQ ActiveX Component.

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.Serializes or deserializes an object, or an entire graph of connected objects, to or from the body of a Message Queuing message, using a binary format.

Cursor

Un oggetto Cursor viene uitlizzato per mantenere una posizione specifica in un oggetto MessageQueue durante la lettura dei messaggi della coda.A Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

DefaultPropertiesToSend

Specifica i valori predefiniti delle proprietà che verranno utilizzati per l'invio di oggetti diversi da istanze Message a una coda di messaggi.Specifies the default property values that will be used when sending objects other than Message instances to a message queue.

Message

Fornisce accesso alle proprietà necessarie per definire un messaggio di Accodamento messaggi.Provides access to the properties needed to define a Message Queuing message.

MessageEnumerator

Fornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.Provides a forward-only cursor to enumerate through messages in a message queue.

MessagePropertyFilter

Controlla e seleziona le proprietà recuperate durante la lettura o la ricezione di messaggi da una coda.Controls and selects the properties that are retrieved when peeking or receiving messages from a message queue.

MessageQueue

Fornisce l'accesso a una coda su un server di Accodamento messaggi.Provides access to a queue on a Message Queuing server.

MessageQueueAccessControlEntry

Specifica i diritti di accesso per un fiduciario (utente, gruppo o computer) per eseguire attività di Accodamento messaggi.Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

MessageQueueCriteria

Filtra le code dei messaggi durante l'esecuzione di una query, mediante il metodo MessageQueue della classe GetPublicQueues().Filters message queues when performing a query using the MessageQueue class's GetPublicQueues() method.

MessageQueueEnumerator

Fornisce un cursore forward-only per enumerare i messaggi in una coda di messaggi.Provides a forward-only cursor to enumerate through messages in a message queue.

MessageQueueException

Eccezione generata quando si verifica un errore interno di Servizi Accodamento messaggi Microsoft.The exception that is thrown if a Microsoft Message Queuing internal error occurs.

MessageQueueInstaller

Consente di installare e configurare una coda necessaria all'esecuzione dell'applicazione.Allows you to install and configure a queue that your application needs in order to run. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di un oggetto MessageQueue.This class is called by the installation utility, for example, InstallUtil.exe, when installing a MessageQueue.

MessageQueuePermission

Consente di controllare le autorizzazioni di accesso al codice per la messaggistica.Allows control of code access permissions for messaging.

MessageQueuePermissionAttribute

Consente di controllare le autorizzazioni dichiarative MessageQueue.Allows declarative MessageQueue permission checks.

MessageQueuePermissionEntry

Definisce l'unità più piccola di un'autorizzazione di sicurezza per l'accesso al codice per la messaggistica.Defines the smallest unit of a code access security permission set for messaging.

MessageQueuePermissionEntryCollection

Contiene una raccolta fortemente tipizzata di oggetti MessageQueuePermissionEntry.Contains a strongly typed collection of MessageQueuePermissionEntry objects.

MessageQueueTransaction

Fornisce una transazione interna di Accodamento messaggi.Provides a Message Queuing internal transaction.

MessagingDescriptionAttribute

Specifica una descrizione per una proprietà o un evento.Specifies a description for a property or event.

PeekCompletedEventArgs

Fornisce dati per l'evento PeekCompleted.Provides data for the PeekCompleted event. Quando l'operazione di visualizzazione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.

ReceiveCompletedEventArgs

Fornisce dati per l'evento ReceiveCompleted.Provides data for the ReceiveCompleted event. Quando l'operazione di ricezione asincrona chiama un gestore eventi, un'istanza di questa classe viene passata al gestore.When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.

SecurityContext

Rappresenta il contesto di sicurezza di un messaggio della coda.Represents the security context for a message in a queue.

Trustee

Specifica un account utente, un account di gruppo o la sessione di accesso a cui si applica una voce di controllo di accesso.Specifies a user account, group account, or logon session to which an access control entry applies.

XmlMessageFormatter

Serializza e deserializza oggetti nel e dal corpo di un messaggio, utilizzando il formato XML basato sulla definizione di schema XSD.Serializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.

Interfacce

IMessageFormatter

Serializza o deserializza gli oggetti dal corpo di un messaggio di Accodamento messaggi.Serializes or deserializes objects from the body of a Message Queuing message.

Enumerazioni

AccessControlEntryType

Specifica se concedere, negare o revocare i diritti di accesso a un fiduciario.Specifies whether to allow, deny, or revoke access rights for a trustee.

AcknowledgeTypes

Specifica i tipi di messaggio di conferma che Accodamento messaggi restituisce all'applicazione mittente.Specifies the types of acknowledgment message that Message Queuing returns to the sending application.

Acknowledgment

Specifica il risultato del tentativo di consegna di un messaggio.Specifies the result of an attempted message delivery.

CryptographicProviderType

Specifica i provider del servizio di crittografia disponibili per la convalida delle firme digitali.Specifies the cryptographic service providers available for validating digital signatures.

EncryptionAlgorithm

Specifica l'algoritmo utilizzato per crittografare il corpo di un messaggio privato.Specifies the encryption algorithm used to encrypt the message body of a private message.

EncryptionRequired

Specifica il livello di riservatezza dei messaggi ricevuti dalla coda.Specifies the privacy level of messages received by the queue.

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.Uses the Windows 2000 and Windows NT access format to specify a set of common access rights that Message Queuing maps to both standard and object-specific access rights for reading, writing, and executing.

HashAlgorithm

Specifica l'algoritmo hash usato da Accodamento messaggi per l'autenticazione dei messaggi.Specifies the hash algorithm used by Message Queuing when authenticating messages.

MessageLookupAction

Specifica un messaggio da leggere o ricevere da una coda messaggi.Specifies a message to peek at or receive from a message queue.

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.Specifies the priority Message Queuing applies to a message while it is en route to a queue, and when inserting the message into the destination queue.

MessageQueueAccessRights

Stabilisce un gruppo di diritti di accesso specifici dell'oggetto per operazioni che interessano Accodamento messaggi.Specifies a set of object-specific access rights for operations specific to Message Queuing.

MessageQueueErrorCode

Identifica l'origine di un errore verificatosi all'interno dell'applicazione Accodamento messaggi e che ha generato un'eccezione MessageQueueException.Identifies the source of an error that occurred within the Message Queuing application and generated a MessageQueueException exception.

MessageQueuePermissionAccess

Definisce i livelli di accesso utilizzati dalle classi di autorizzazione System.Messaging.Defines access levels used by System.Messaging permission classes.

MessageQueueTransactionStatus

Specifica lo stato di una transazione interna di Accodamento messaggi.Specifies the state of an internal Message Queuing transaction.

MessageQueueTransactionType

Specifica il tipo di una transazione di Accodamento messaggi.Specifies the type of a Message Queuing transaction.

MessageType

Identifica il tipo di messaggio,Identifies the type of a message. che può essere un tipico messaggio di Accodamento messaggi, un messaggio di conferma positivo o negativo (arrivo e lettura) oppure un messaggio di report.A message can be a typical Message Queuing message, a positive (arrival and read) or negative (arrival and read) acknowledgment message, or a report message.

PeekAction

Indica se leggere il messaggio corrente in una coda oppure il messaggio successivo.Indicates whether to peek the current message in a queue, or the next message.

QueueAccessMode

Specifica la modalità di accesso per un oggetto MessageQueue al momento della creazione.Specifies the access mode for a MessageQueue at creation time.

StandardAccessRights

Specifica una serie di diritti di accesso standard che corrispondono alle operazioni comuni alla maggior parte dei tipi di oggetti proteggibili.Specifies a set of standard access rights that correspond to operations common to most types of securable objects.

TrusteeType

Specifica il tipo di fiduciario.Specifies the type of a trustee.

Delegati

PeekCompletedEventHandler

Rappresenta il metodo che gestirà l'evento PeekCompleted di un oggetto MessageQueue.Represents the method that will handle the PeekCompleted event of a MessageQueue.

ReceiveCompletedEventHandler

Rappresenta il metodo che gestirà l'evento ReceiveCompleted di un oggetto MessageQueue.Represents the method that will handle the ReceiveCompleted event of a MessageQueue.

Commenti

I membri del MessageQueue classe includono i seguenti metodi per la lettura e scrittura dei messaggi alla coda:Members of the MessageQueue class include the following methods for reading and writing messages to the queue:

  • Il Send metodo consente all'applicazione di scrivere i messaggi nella coda.The Send method enables your application to write messages to the queue. Gli overload del metodo consentono di specificare se inviare il messaggio utilizzando una Message (che fornisce un controllo dettagliato sulle informazioni inviate) o qualsiasi altro oggetto gestito, incluse le classi specifiche dell'applicazione.Overloads of the method enable you to specify whether to send your message using a Message (which provides detailed control over the information you send) or any other managed object, including application-specific classes. Il metodo supporta anche l'invio di messaggi come parte di una transazione.The method also supports sending messages as part of a transaction.

  • Il Receive, ReceiveById, e ReceiveByCorrelationId metodi forniscono funzionalità per la lettura dei messaggi da una coda.The Receive, ReceiveById, and ReceiveByCorrelationId methods provide functionality for reading messages from a queue. Ad esempio il Send (metodo), tali metodi forniscono overload che supportano l'elaborazione coda transazionale.Like the Send method, these methods provide overloads that support transactional queue processing. Questi metodi forniscono anche gli overload con timeout.These methods also provide overloads with time-out.

    I parametri out che consentono l'elaborazione di continuare se la coda è vuota.Out parameters that enable processing to continue if the queue is empty. Poiché questi metodi sono esempi di elaborazione sincrona, determinano l'interruzione del thread corrente fino a quando non è disponibile, un messaggio solo se si specifica un timeout.Because these methods are examples of synchronous processing, they interrupt the current thread until a message is available, unless you specify a time-out.

  • Il Peek è simile a metodo Receive, ma non provoca un messaggio da rimuovere dalla coda quando viene letta.The Peek method is similar to Receive, but it does not cause a message to be removed from the queue when it is read. Poiché Peek non cambia il contenuto della coda, non sono presenti overload per supportare l'elaborazione transazionale.Because Peek does not change the queue contents, there are no overloads to support transactional processing. Tuttavia, poiché Peek, ad esempio Receive, in modo sincrono legge i messaggi dalla coda, gli overload del metodo supporta l'indicazione di un timeout allo scopo di impedire che il thread in attesa per un periodo illimitato.However, because Peek, like Receive, reads messages synchronously from the queue, overloads of the method do support specifying a time-out in order to prevent the thread from waiting indefinitely.

  • Il BeginPeek, EndPeek(IAsyncResult), BeginReceive, e EndReceive(IAsyncResult) metodi consentono di leggere in modo asincrono i messaggi dalla coda.The BeginPeek, EndPeek(IAsyncResult), BeginReceive, and EndReceive(IAsyncResult) methods provide ways to asynchronously read messages from the queue. Non interrompono il thread corrente durante l'attesa di un messaggio in arrivo nella coda.They do not interrupt the current thread while waiting for a message to arrive in the queue.

I metodi seguenti del MessageQueue classe fornisce la funzionalità per il recupero di elenchi di code con i criteri specificati e per determinare se esistono code specifiche:The following methods of the MessageQueue class provide functionality for retrieving lists of queues by specified criteria and determining if specific queues exist:

Altri metodi per il MessageQueue classe offrono le funzionalità seguenti:Other methods of the MessageQueue class provide the following functionality:

  • Creazione ed eliminazione di code di accodamento dei messaggi.Creating and deleting Message Queueing queues.

  • Utilizzo di un enumeratore di messaggio per esaminare i messaggi in una coda.Using a message enumerator to step through the messages in a queue.

  • Utilizzo di un enumeratore di coda per l'iterazione tra le code nel sistema.Using a queue enumerator for iterating through the queues on the system.

  • Impostazione dei diritti di accesso basate sull'elenco ACL.Setting ACL-based access rights.

  • Funzionamento della cache di connessione.Working with the connection cache.

Il Message classe fornisce un controllo dettagliato sulle informazioni inviate a una coda ed è l'oggetto usato durante la ricezione o la visualizzazione dei messaggi da una coda.The Message class provides detailed control over the information you send to a queue, and is the object used when receiving or peeking messages from a queue. Oltre al corpo del messaggio, le proprietà del Message classe includono le impostazioni di conferma, la selezione del formattatore, identificazione, l'autenticazione e crittografia, i timestamp, le indicazioni sull'utilizzo di traccia, del diario del server e le code non recapitabilità e i dati della transazione.Besides the message body, the properties of the Message class include acknowledgment settings, formatter selection, identification, authentication and encryption information, timestamps, indications about using tracing, server journaling, and dead-letter queues, and transaction data.

Il MessageQueue componente sono associati i formattatori di tre seguenti, che consentono di serializzare e deserializzare i messaggi inviati e ricevuti dalle code:The MessageQueue component is associated with the following three formatters, which enable you to serialize and deserialize messages sent and received from queues:

  • Il XmlMessageFormatter fornisce messaggistica accoppiamento, l'abilitazione di controllo delle versioni indipendente dei tipi serializzati sul client e server.The XmlMessageFormatter provides loosely coupled messaging, enabling independent versioning of serialized types on the client and server.

  • Il ActiveXMessageFormatter è compatibile con il controllo COM di MSMQ.The ActiveXMessageFormatter is compatible with the MSMQ COM control. Consente di inviare i tipi che possono essere ricevuti dal controllo e di ricevere i tipi che sono stati inviati dal controllo.It allows you to send types that can be received by the control and to receive types that were sent by the control.

  • Il BinaryMessageFormatter offre un'alternativa più veloce per il XmlMessageFormatter, ma senza il vantaggio della messaggistica a regime.The BinaryMessageFormatter provides a faster alternative to the XmlMessageFormatter, but without the benefit of loosely coupled messaging.

Le altre classi dei Messaging dello spazio dei nomi supportano dall'accesso di codice e la sicurezza basata sugli ACL, il filtro Message proprietà durante la lettura dei messaggi da una coda e utilizzo delle transazioni durante l'invio e ricezione dei messaggi.Other classes in the Messaging namespace support code-access and ACL-based security, filtering Message properties when reading messages from a queue, and using transactions when sending and receiving messages.