System.Messaging 네임스페이스

System.Messaging 네임스페이스는 네트워크에서 메시지 큐에 연결, 모니터링 및 관리하고 메시지를 보내고 받거나 피크(peek)할 수 있는 클래스를 제공합니다. 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.

클래스

AccessControlEntry

애플리케이션별 일반 작업을 구현할 트러스티(사용자, 그룹 또는 컴퓨터)에 대한 액세스 권한을 지정합니다.Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

AccessControlList

하나 이상의 트러스트를 받을 대상에 대한 액세스 권한을 지정하는 액세스 제어 항목의 목록이 포함되어 있습니다.Contains a list of access control entries, specifying access rights for one or more trustees.

ActiveXMessageFormatter

MSMQ ActiveX 구성 요소와 호환되는 형식을 사용하여 메시지 큐 메시지의 본문으로 또는 메시지 큐 메시지의 본문에서 기본 데이터 형식과 다른 개체를 serialize하거나 deserialize합니다.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

개체나 연결된 개체의 전체 그래프를 메시지 큐 본문으로 또는 메시지 큐 본문에서 이진 형식으로 serialize하거나 deserialize합니다.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

CursorMessageQueue의 메시지를 읽을 때 큐의 특정 위치를 유지하는 데 사용됩니다.A Cursor is used to maintain a specific location in a MessageQueue when reading the queue's messages.

DefaultPropertiesToSend

Message 인스턴스 이외의 개체를 메시지 큐로 보내는 데 사용되는 기본 속성 값을 지정합니다.Specifies the default property values that will be used when sending objects other than Message instances to a message queue.

Message

메시지 큐 메시지를 정의하는 데 필요한 속성의 액세스 권한을 제공합니다.Provides access to the properties needed to define a Message Queuing message.

MessageEnumerator

앞으로만 이동 가능한 커서를 제공하여 메시지 큐에 있는 메시지를 열거합니다.Provides a forward-only cursor to enumerate through messages in a message queue.

MessagePropertyFilter

메시지 큐에서 메시지를 피킹하거나 받을 때 검색되는 속성을 제어하고 선택합니다.Controls and selects the properties that are retrieved when peeking or receiving messages from a message queue.

MessageQueue

메시지 큐 서버에 있는 큐에 대한 액세스를 제공합니다.Provides access to a queue on a Message Queuing server.

MessageQueueAccessControlEntry

트러스티(사용자, 그룹 또는 컴퓨터)가 메시지 큐 작업을 수행할 수 있는 액세스 권한을 지정합니다.Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

MessageQueueCriteria

쿼리를 수행할 때 MessageQueue 클래스의 GetPublicQueues() 메서드를 사용하여 메시지 큐를 필터링합니다.Filters message queues when performing a query using the MessageQueue class's GetPublicQueues() method.

MessageQueueEnumerator

메시지 큐의 메시지를 열거하는 정방향 전용 커서를 제공합니다.Provides a forward-only cursor to enumerate through messages in a message queue.

MessageQueueException

Microsoft Message Queuing 내부 오류가 발생한 경우에 throw되는 예외입니다.The exception that is thrown if a Microsoft Message Queuing internal error occurs.

MessageQueueInstaller

애플리케이션을 실행하는 데 필요한 큐를 설치하고 구성할 수 있도록 합니다.Allows you to install and configure a queue that your application needs in order to run. 이 클래스는 MessageQueue를 설치할 때 InstallUtil.exe와 같은 설치 유틸리티에서 호출됩니다.This class is called by the installation utility, for example, InstallUtil.exe, when installing a MessageQueue.

MessageQueuePermission

메시징에 대한 코드 액세스 권한 제어를 허용합니다.Allows control of code access permissions for messaging.

MessageQueuePermissionAttribute

MessageQueue 권한을 선언적으로 확인할 수 있습니다.Allows declarative MessageQueue permission checks.

MessageQueuePermissionEntry

메시징에 대해 설정된 코드 액세스 보안 권한의 최소 단위를 정의합니다.Defines the smallest unit of a code access security permission set for messaging.

MessageQueuePermissionEntryCollection

MessageQueuePermissionEntry 개체의 강력한 형식의 컬렉션을 포함합니다.Contains a strongly typed collection of MessageQueuePermissionEntry objects.

MessageQueueTransaction

메시지 큐 내부 트랜잭션을 제공합니다.Provides a Message Queuing internal transaction.

MessagingDescriptionAttribute

속성 또는 이벤트에 대한 설명을 지정합니다.Specifies a description for a property or event.

PeekCompletedEventArgs

PeekCompleted 이벤트에 대한 데이터를 제공합니다.Provides data for the PeekCompleted event. 비동기 피킹(peeking) 작업에서 이벤트 처리기가 호출되면 이 클래스의 인스턴스가 해당 처리기로 전달됩니다.When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.

ReceiveCompletedEventArgs

ReceiveCompleted 이벤트에 대한 데이터를 제공합니다.Provides data for the ReceiveCompleted event. 비동기 수신 작업에서 이벤트 처리기가 호출되면 이 클래스의 인스턴스가 해당 처리기로 전달됩니다.When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.

SecurityContext

큐의 메시지에 대한 보안 컨텍스트를 나타냅니다.Represents the security context for a message in a queue.

Trustee

사용자 계정, 그룹 계정 또는 액세스 제어 항목이 적용되는 로그온 세션을 지정합니다.Specifies a user account, group account, or logon session to which an access control entry applies.

XmlMessageFormatter

XSD 스키마 정의에 기반한 XML 형식을 사용하여 개체를 메시지 본문 간에 serialize 및 deserialize합니다.Serializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.

인터페이스

IMessageFormatter

메시지 큐 메시지 본문에서 개체를 serialize하거나 deserialize합니다.Serializes or deserializes objects from the body of a Message Queuing message.

열거형

AccessControlEntryType

트러스티에 대한 액세스 권한을 허용, 거부 또는 취소하도록 지정합니다.Specifies whether to allow, deny, or revoke access rights for a trustee.

AcknowledgeTypes

메시지 큐에서 보내는 애플리케이션으로 반환하는 승인 메시지의 형식을 지정합니다.Specifies the types of acknowledgment message that Message Queuing returns to the sending application.

Acknowledgment

시도된 메시지 배달 결과를 지정합니다.Specifies the result of an attempted message delivery.

CryptographicProviderType

디지털 서명 확인을 위한 암호화 서비스 공급자를 지정합니다.Specifies the cryptographic service providers available for validating digital signatures.

EncryptionAlgorithm

프라이빗 메시지의 본문을 암호화하는 데 사용되는 암호화 알고리즘을 지정합니다.Specifies the encryption algorithm used to encrypt the message body of a private message.

EncryptionRequired

큐에서 받은 메시지의 개인 정보 수준을 지정합니다.Specifies the privacy level of messages received by the queue.

GenericAccessRights

Windows 2000 및 Windows NT 액세스 형식을 사용하여 메시지 큐가 읽기, 쓰기 및 실행에 대한 표준 액세스 권한과 개체별 액세스 권한으로 모두 매핑하는 일반적인 액세스 권한 집합을 설정합니다.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

메시지를 인증할 때 메시지 큐에서 사용하는 해시 알고리즘을 지정합니다.Specifies the hash algorithm used by Message Queuing when authenticating messages.

MessageLookupAction

메시지 큐에서 피킹하거나 받을 메시지를 지정합니다.Specifies a message to peek at or receive from a message queue.

MessagePriority

메시지가 큐로 이동하고 대상 큐에 삽입될 때 메시지 큐가 메시지에 적용하는 우선 순위를 지정합니다.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

메시지 큐 관련 작업에 대한 개체별 액세스 권한 집합을 지정합니다.Specifies a set of object-specific access rights for operations specific to Message Queuing.

MessageQueueErrorCode

메시지 큐 애플리케이션에서 발생하고 MessageQueueException 예외를 생성한 오류의 원인을 식별합니다.Identifies the source of an error that occurred within the Message Queuing application and generated a MessageQueueException exception.

MessageQueuePermissionAccess

System.Messaging 권한 클래스에서 사용되는 액세스 수준을 정의합니다.Defines access levels used by System.Messaging permission classes.

MessageQueueTransactionStatus

내부 메시지 큐 트랜잭션의 상태를 지정합니다.Specifies the state of an internal Message Queuing transaction.

MessageQueueTransactionType

메시지 큐 트랜잭션 형식을 지정합니다.Specifies the type of a Message Queuing transaction.

MessageType

메시지 형식을 식별합니다.Identifies the type of a message. 메시지에는 일반 메시지 큐 메시지, 긍정(도착 및 읽기) 또는 부정(도착 및 읽기) 승인 메시지 또는 보고 메시지가 있습니다.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

큐의 현재 메시지를 피킹할지 또는 다음 메시지를 피킹할지 여부를 나타냅니다.Indicates whether to peek the current message in a queue, or the next message.

QueueAccessMode

MessageQueue를 만들 때 이 큐의 액세스 모드를 지정합니다.Specifies the access mode for a MessageQueue at creation time.

StandardAccessRights

대부분의 보안 가능한 개체 형식에 공통되는 작업에 대한 표준 액세스 권한 집합을 지정합니다.Specifies a set of standard access rights that correspond to operations common to most types of securable objects.

TrusteeType

트러스티 형식을 지정합니다.Specifies the type of a trustee.

대리자

PeekCompletedEventHandler

PeekCompletedMessageQueue 이벤트를 처리할 메서드를 나타냅니다.Represents the method that will handle the PeekCompleted event of a MessageQueue.

ReceiveCompletedEventHandler

ReceiveCompletedMessageQueue 이벤트를 처리할 메서드를 나타냅니다.Represents the method that will handle the ReceiveCompleted event of a MessageQueue.

설명

멤버는 MessageQueue 메시지 읽기 및 쓰기를 큐에 대 한 다음 메서드를 포함 하는 클래스:Members of the MessageQueue class include the following methods for reading and writing messages to the queue:

  • Send 메서드를 사용 하면 큐에 메시지를 작성 하도록 응용 프로그램입니다.The Send method enables your application to write messages to the queue. 메서드의 오버 로드를 사용 하 여 메시지를 보낼지 여부를 지정할 수는 Message (자세히 제어 전송 되는 정보를 제공 하는) 또는 애플리케이션 관련 클래스를 포함 한 다른 관리 되는 개체를 합니다.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. 메서드는 또한 트랜잭션의 일부로 보내는 메시지를 지원합니다.The method also supports sending messages as part of a transaction.

  • 합니다 Receive, ReceiveById, 및 ReceiveByCorrelationId 메서드는 큐에서 메시지를 읽는 기능을 제공 합니다.The Receive, ReceiveById, and ReceiveByCorrelationId methods provide functionality for reading messages from a queue. 같은 Send 메서드를 이러한 메서드는 트랜잭션 큐 처리를 지 원하는 오버 로드를 제공 합니다.Like the Send method, these methods provide overloads that support transactional queue processing. 이러한 메서드는 또한 제한 시간을 사용 하 여 오버 로드를 제공합니다.These methods also provide overloads with time-out.

    Out 매개 변수는 큐가 비어 있는지를 계속 처리 하는 것이 있도록 합니다.Out parameters that enable processing to continue if the queue is empty. 이러한 메서드는 동기식 처리가 예가 이기 때문에 이러한 제한 시간을 지정 하지 않으면 메시지를 사용할 때까지 현재 스레드를 중단 합니다.Because these methods are examples of synchronous processing, they interrupt the current thread until a message is available, unless you specify a time-out.

  • 합니다 Peek 메서드는 비슷합니다 Receive, 하지만 메시지를 읽을 때 큐에서 제거 되지는지 않습니다.The Peek method is similar to Receive, but it does not cause a message to be removed from the queue when it is read. 때문에 Peek 큐의 내용을 변경 되지 않습니다 트랜잭션 처리를 지원 하기 위해 오버 로드가 없는 합니다.Because Peek does not change the queue contents, there are no overloads to support transactional processing. 그러나 때문 Peek같은 Receive큐에서 메시지를 동기적으로 읽고, 제한 시간을 무기한 대기 스레드를 방지 하기 위해 지정 메서드의 오버 로드 지원지 않습니다.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.

  • 합니다 BeginPeek, EndPeek(IAsyncResult)BeginReceive, 및 EndReceive(IAsyncResult) 메서드를 비동기적으로 큐에서 메시지를 읽는 방법을 제공 합니다.The BeginPeek, EndPeek(IAsyncResult), BeginReceive, and EndReceive(IAsyncResult) methods provide ways to asynchronously read messages from the queue. 메시지가 큐에 도착할 때까지 기다리는 동안 현재 스레드를 중단 하지 있습니다.They do not interrupt the current thread while waiting for a message to arrive in the queue.

다음 메서드는 MessageQueue 클래스 지정된 조건으로 큐 목록을 검색 및 특정 큐가 있는지 확인 하기 위한 기능을 제공 합니다.The following methods of the MessageQueue class provide functionality for retrieving lists of queues by specified criteria and determining if specific queues exist:

다른 메서드는 MessageQueue 클래스에는 다음 기능을 제공 합니다.Other methods of the MessageQueue class provide the following functionality:

  • 페이지를 만들고 메시지 큐에서 큐를 삭제 합니다.Creating and deleting Message Queueing queues.

  • 메시지 열거자를 사용 하 여 큐에서 메시지를 단계별로 실행 하려면.Using a message enumerator to step through the messages in a queue.

  • 큐 열거자를 사용 하 여 시스템에 있는 큐를 반복 합니다.Using a queue enumerator for iterating through the queues on the system.

  • ACL 기준 액세스 권한을 설정 합니다.Setting ACL-based access rights.

  • 캐시 작업에 연결 합니다.Working with the connection cache.

Message 클래스 세부적된으로 제어 큐로 전송 되는 정보를 제공 하며 큐에서 메시지를 받거나 피킹할 때 개체가 사용 됩니다.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. 메시지 본문의 속성 외에도 Message 승인, 설정, 포맷터 선택, 식별, 인증 및 암호화 정보, 타임 스탬프, 추적, server 저널링을 사용 하 여에 대 한 표시가 클래스를 포함 하 고 배달 못 한 편지 큐 및 트랜잭션 데이터입니다.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.

MessageQueue 직렬화 및 큐에서 보내고 받은 메시지를 역직렬화 할 수 있도록 하는 다음 세 가지 포맷터와 연관 된 구성 요소:The MessageQueue component is associated with the following three formatters, which enable you to serialize and deserialize messages sent and received from queues:

  • XmlMessageFormatter 제공 느슨하게 결합 된 메시징, 클라이언트와 서버에서 serialize 된 형식의 독립 된 버전 관리를 사용 하도록 설정 합니다.The XmlMessageFormatter provides loosely coupled messaging, enabling independent versioning of serialized types on the client and server.

  • ActiveXMessageFormatter MSMQ COM 컨트롤과 호환 됩니다.The ActiveXMessageFormatter is compatible with the MSMQ COM control. 컨트롤에서 받을 수 있는 유형을 전송 하 고 컨트롤에서 보낸 형식 받을 수 있습니다.It allows you to send types that can be received by the control and to receive types that were sent by the control.

  • BinaryMessageFormatter 빠르게 제공는 XmlMessageFormatter, 않고 느슨하게 결합 된 메시징 활용 합니다.The BinaryMessageFormatter provides a faster alternative to the XmlMessageFormatter, but without the benefit of loosely coupled messaging.

다른 클래스는 Messaging 네임 스페이스는 코드 액세스 및 ACL 기반 보안 지원 필터링 Message 큐에서 메시지를 읽고 보내고 받을 때 트랜잭션을 사용 하 여 메시지 속성입니다.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.