Обзор Message Queuing

В пространстве имен System.Messaging определены классы, которые позволяют выполнять чтение и запись сообщений с использованием такого предлагаемого в составе операционной системы Windows средства для организации сообщений, как .

Обмен сообщениями может применяться в сценарии автономной работы, в котором не требуется, чтобы клиент и сервер обязательно запускались в одно и то же время.

Прежде чем углубляться в детали программирования с использованием Message Queuing, в данной статье я предлагаю ознакомиться с основными концепциями организации очередей сообщений и сравнить их с концепциями синхронного и асинхронного программирования.

При синхронном программировании, когда вызывается метод, то вызвавший его код должен ожидать, пока метод не завершит свою работу. При асинхронном программировании вызывающий поток запускает метод и параллельно продолжает свою работу. Асинхронное программирование основано на применении делегатов, библиотек классов, которые уже поддерживают асинхронные методы (например, прокси-классы веб-служб и классы из пространств System.Net и System.IO), либо специальных потоков. Как при синхронном, так и при асинхронном программировании клиент и сервер должны работать в одно и то же время.

Хотя Message Queuing работает асинхронно, поскольку клиент (отправитель) не ожидает прочтения получателем (сервером) оправленных ему данных, между Message Queuing и асинхронным программированием существует принципиальная разница: Message Queuing может выполняться в автономной (отключенной) среде. На момент отправки данных их получатель может быть отключен. Позднее, когда получатель подключится, он получит данные без вмешательства отправляющего приложения.

Подключенное и отключенное программирование можно сравнить с разговором по телефону и отправкой почтовых сообщений. При разговоре с кем-либо по телефону оба участника должны быть подключены одновременно — это синхронная коммуникация. В случае обмена электронной почтой отправитель не знает, когда его послание будет прочитано. Люди, использующие эту технологию, работают в автономном (отключенном) режиме.

Конечно, может случиться так, что почта не будет прочитана никогда, а просто проигнорирована. Такова природа отключенных коммуникаций. Чтобы избежать этой проблемы, можно запросить ответ или подтверждение факта прочтения письма. Если ответ не придет в течение определенного времени, возможно, придется как-то справляться с таким «исключением». Все это также возможно в Message Queuing.

Message Queuing, по сути, можно считать технологией для обмена электронными сообщениями между приложениями, а не людьми. Она обладает множеством функциональных возможностей, которые в других службах обмена сообщениями не доступны: гарантированием доставки, применением транзакций, получением подтверждений, экспресс-режимом, использующим память, и т.д. Message Queuing предлагает массу полезных средств для коммуникаций между приложениями.

С помощью Message Queuing можно отправлять, принимать и маршрутизировать сообщения в подключенной и отключенной (автономной) среде. На рисунке ниже показан очень простой способ использования сообщений. Отправитель посылает сообщения в очередь сообщений, а получатель принимает их из этой очереди:

Когда следует использовать Message Queuing

Одной из ситуаций, в которых удобно применять Message Queuing — это когда клиентское приложение часто отключается от сети (например, у коммивояжера, навещающего заказчиков на местах). Коммивояжер может вводить данные заказа непосредственно у заказчика. Приложение ставит сообщение о каждом заказе в очередь сообщений, находящуюся на клиентской системе. Как только коммивояжер возвращается в свой офис, заказ автоматически передается из очереди сообщений клиентской системы в очередь сообщений целевой системы, где и обрабатывается.

Помимо портативного компьютера, коммивояжер может использовать устройство Pocket Windows, где также доступно Message Queuing.

Технология Message Queuing может быть полезна и в подключенной среде. Представьте сайт электронной коммерции (показан на рисунке ниже), где в определенные периоды времени сервер полностью загружен обработкой заказов, например, в ранний вечер и в выходные, при этом по ночам нагрузка значительно уменьшается. Решение проблемы может состоять в приобретении более быстрого сервера или в добавлении дополнительных серверов к системе, чтобы они справлялись с пиковыми нагрузками.

Однако существует более дешевое решение: сгладить пиковые нагрузки, сдвинув транзакции со времени максимальных нагрузок на время с низкой загрузкой. В такой схеме заказы отправляются в очередь сообщений, а принимающая сторона читает их тогда, когда это удобно системе базы данных. Таким образом, нагрузка на систему сглаживается по времени, так что сервер, обрабатывающий транзакции, может быть дешевле и не требовать модернизации:

Функциональные возможности Message Queuing

Технология Message Queuing является службой, которая поставляется как часть операционной системы Windows. Ниже перечислены ее основные функциональные возможности:

Сообщения могут пересылаться в автономной среде. То есть приложению-отправителю и приложению-получателю вовсе не обязательно выполняться в одно и то же время.

В экспресс-режиме сообщения могут пересылаться очень быстро. В экспресс-режиме сообщения просто сохраняются в памяти.

Для механизма восстановления сообщения могут отправляться с гарантированной доставкой. Такие сообщения сохраняются в файлах и доставляются даже в случае перезагрузки сервера.

Очереди сообщений могут защищаться с применением списков контроля доступа и указания в них, каким пользователям разрешено отправлять или получать сообщения из очереди. Кроме того, сообщения могут шифроваться для исключения вероятности их прочтения с помощью сетевых анализаторов пакетов, а также снабжаться приоритетами, чтобы те из них, которые имеют более высокий приоритет, обрабатывались быстрее.

В Message Queuing 3.0 поддерживается возможность отправки многоадресных (multicast) сообщений.

В Message Queuing 4.0 поддерживается возможность распознавания вредоносных сообщений. Для таких сообщений может быть определена специальная очередь.

Например, в случае, если после прочтения сообщения из обычной очереди, далее оно должно вставляться в базу данных, но по какой-то причине этого не происходит, это сообщение может быть отправлено в очередь вредоносных сообщений. Впоследствии этой очередью вредоносных сообщений должен кто-нибудь заняться и выяснить, по какой причине адрес сообщения не удалось преобразовать.

В Message Queuing 5.0 поддерживаются более безопасные алгоритмы аутентификации, и может обрабатываться большее количество очередей. (В Message Queuing 4.0 при обработке нескольких тысяч очередей начинали возникать проблемы с производительностью.)

Из-за того, что Message Queuing является частью операционной системы, установить версию Message Queuing 5.0 в системе Windows XP или Windows Server 2003 не получится. Эта версия входит в состав ОС Windows Server 2008 R2 и Windows 7.

Продукты Message Queuing

Версия Message Queuing 5.0 поставляется в составе Windows 7 и Windows Server 2008 R2. В Windows 2000 входила версия Message Queuing 2.0, в которой не было поддержки ни протокола HTTP, ни многоадресных сообщений. Версия Message Queuing 3.0 поставлялась в составе Windows XP и Windows Server 2003, а версия Message Queuing 4.0 — в составе Windows Vista и Windows Server 2003.

При использовании ссылки Turn Windows Features on or off (Включение или отключение компонентов Windows), которая предлагается в Windows 7 в окне Configuring Programs and Features (Программы и компоненты), можно обнаружить отдельный раздел с опциями, касающимися Message Queuing:

В этом разделе доступны для выбора перечисленные ниже компоненты:

Microsoft Message Queue (MSMQ) Server Core

Основные компоненты сервера очереди сообщений (MSMQ), которые необходимы для получения базовой функциональности Message Queuing.

Active Directory Domain Services Integration

Интеграция MSMQ доменных служб Active Directory. Это средство позволяет записывать имена очередей сообщений в Active Directory. С помощью этой опции можно находить очереди в Active Directory и защищать их на основе пользователей и групп пользователей Windows.

MSMQ HTTP Support

Поддержка протокола HTTP MSMQ. Поддержка MSMQ HTTP позволяет отправлять и принимать сообщения, используя протокол HTTP.

Triggers

С помощью триггеров создаются экземпляры приложений при поступлении нового сообщения.

Multicast Support

Поддержка многоадресной рассылки. Позволяет отправлять сообщения группам серверов.

MSMQ DCOM Proxy

С помощью DCOM-прокси система может подключаться к удаленному серверу, используя API-интерфейс DCOM.

После установки Message Queuing в системе должна быть обязательно запущена служба Message Queuing (показана на рисунке). Эта служба читает и записывает сообщения, а также взаимодействует с другими серверами Message Queuing для осуществления маршрутизации сообщений по сети:

Установка системы очередей сообщений (MSMQ) Installing Message Queuing (MSMQ)

В процедурах ниже показана методика установки очереди сообщений 4.0 и очереди сообщений 3.0. The following procedures show how to install Message Queuing 4.0 and Message Queuing 3.0.

Служба очереди сообщений 4,0 недоступна в Windows XP и Windows Server 2003. Message Queuing 4.0 is not available in Windows XP and Windows Server 2003.

Установка Message Queuing 4.0 в Windows Server 2008 или Windows Server 2008 R2 To install Message Queuing 4.0 on Windows Server 2008 or Windows Server 2008 R2

В диспетчер сервера щелкните компоненты. In Server Manager, click Features.

В области справа в разделе Сводка компонентов щелкните Добавить компоненты. In the right-hand pane under Features Summary, click Add Features.

В открывшемся окне разверните очередь сообщений. In the resulting window, expand Message Queuing.

Разверните узел службы очередей сообщений. Expand Message Queuing Services.

Щелкните Интеграция служб каталогов (для компьютеров, присоединенных к домену), а затем щелкните Поддержка HTTP. Click Directory Services Integration (for computers joined to a Domain), then click HTTP Support.

Нажмите кнопку Далее, а затем — установить. Click Next,then click Install.

Установка очереди сообщений 4.0 в Windows 7 или Windows Vista To install Message Queuing 4.0 on Windows 7 or Windows Vista

Откройте Панель управления. Open Control Panel.

Щелкните программы , а затем в разделе программы и компоненты щелкните Включение и отключение компонентов Windows. Click Programs and then, under Programs and Features, click Turn Windows Features on and off.

Разверните сервер очереди сообщений Microsoft (MSMQ), разверните ядро сервера очереди сообщений Microsoft (MSMQ) и затем отметьте флажками установку следующих возможностей очереди сообщений: Expand Microsoft Message Queue (MSMQ) Server, expand Microsoft Message Queue (MSMQ) Server Core, and then select the check boxes for the following Message Queuing features to install:

MSMQ Доменные службы Active Directory (для компьютеров, подключенных к домену). MSMQ Active Directory Domain Services Integration (for computers joined to a Domain).

Поддержка MSMQ HTTP. MSMQ HTTP Support.

Нажмите кнопку ОК. Click OK.

Если появится запрос на перезагрузку компьютера, нажмите кнопку ОК , чтобы завершить установку. If you are prompted to restart the computer, click OK to complete the installation.

Установка Message Queuing 3.0 в Windows XP или Windows Server 2003 To install Message Queuing 3.0 on Windows XP and Windows Server 2003

Откройте Панель управления. Open Control Panel.

Щелкните Добавить удалить программы , а затем — Добавить компоненты Windows. Click Add Remove Programs and then click Add Windows Components.

Выберите очередь сообщений и щелкните сведения. Select Message Queuing and click Details.

Если вы используете Windows Server 2003, выберите сервер приложений для доступа к очереди сообщений. If you are running Windows Server 2003, select Application Server to access Message Queuing.

Удостоверьтесь, что на странице сведений выбрана функция поддержки MSMQ HTTP. Ensure that the option MSMQ HTTP Support is selected on the details page.

Нажмите кнопку ОК , чтобы закрыть страницу сведения, а затем нажмите кнопку Далее. Click OK to exit the details page, and then click Next. Завершите установку. Complete the installation.

Если появится запрос на перезагрузку компьютера, нажмите кнопку ОК , чтобы завершить установку. If you are prompted to restart the computer, click OK to complete the installation.

Message Queue Класс

Определение

Предоставляет доступ к очереди на сервере MSMQ. Provides access to a queue on a Message Queuing server.

Примеры

В следующем примере кода создаются новые MessageQueue объекты с использованием различных типов синтаксиса имени пути. The following code example creates new MessageQueue objects using various path name syntax types. В каждом случае он отправляет сообщение в очередь, путь которой определен в конструкторе. In each case, it sends a message to the queue whose path is defined in the constructor.

Следующий пример кода отправляет сообщение в очередь и получает сообщение из очереди, используя класс, зависящий от приложения, с именем Order . The following code example sends a message to a queue, and receives a message from a queue, using an application-specific class called Order .

Комментарии

Технология очередей сообщений позволяет приложениям, работающим в разное время, взаимодействовать через разнородные сети и системы, которые могут быть временно автономными. The Message Queuing technology allows applications running at different times to communicate across heterogeneous networks and systems that might be temporarily offline. Приложения отправляют, получают или считывают (чтение без удаления) сообщения из очередей. Applications send, receive, or peek (read without removing) messages from queues. Служба очереди сообщений является необязательным компонентом Windows 2000 и Windows NT и должна устанавливаться отдельно. Message Queuing is an optional component of Windows 2000 and Windows NT, and must be installed separately.

MessageQueueКласс является оболочкой для очереди сообщений. The MessageQueue class is a wrapper around Message Queuing. Существует несколько версий очереди сообщений, и использование MessageQueue класса может немного различно повлиять на поведение в зависимости от используемой операционной системы. There are multiple versions of Message Queuing, and using the MessageQueue class can result in slightly different behavior, depending on the operating system you are using. Сведения о конкретных функциях каждой версии очереди сообщений см. в разделе «новые возможности очереди сообщений» пакета Platform SDK на сайте MSDN. For information about specific features of each version of Message Queuing, see the topic «What’s New in Message Queuing» in the Platform SDK in MSDN.

MessageQueueКласс предоставляет ссылку на очередь очереди сообщений. The MessageQueue class provides a reference to a Message Queuing queue. Можно указать путь в MessageQueue конструкторе для подключения к существующему ресурсу или создать новую очередь на сервере. You can specify a path in the MessageQueue constructor to connect to an existing resource, or you can create a new queue on the server. Прежде чем можно будет вызвать метод Send(Object) , Peek или Receive , необходимо связать новый экземпляр MessageQueue класса с существующей очередью. Before you can call Send(Object), Peek, or Receive, you must associate the new instance of the MessageQueue class with an existing queue. На этом этапе можно манипулировать свойствами очереди, такими как Category и Label . At that point, you can manipulate the queue properties such as Category and Label.

MessageQueue поддерживает два типа извлечения сообщений: синхронные и асинхронные. MessageQueue supports two types of message retrieval: synchronous and asynchronous. Синхронные методы, Peek и Receive , вызывают поток процесса для ожидания поступления нового сообщения в очередь. The synchronous methods, Peek and Receive, cause the process thread to wait a specified time interval for a new message to arrive in the queue. Асинхронные методы BeginPeek и BeginReceive позволяют основным задачам приложения продолжать работу в отдельном потоке, пока в очередь не поступит сообщение. The asynchronous methods, BeginPeek and BeginReceive, allow the main application tasks to continue in a separate thread until a message arrives in the queue. Эти методы работают, используя объекты обратного вызова и объекты состояния для обмена данными между потоками. These methods work by using callback objects and state objects to communicate information between threads.

При создании нового экземпляра MessageQueue класса новая очередь очередей сообщений не создается. When you create a new instance of the MessageQueue class, you are not creating a new Message Queuing queue. Вместо этого можно использовать Create(String) Delete(String) методы, и Purge для управления очередями на сервере. Instead, you can use the Create(String), Delete(String), and Purge methods to manage queues on the server.

В отличие от Purge , Create(String) и Delete(String) являются static членами, поэтому их можно вызывать без создания нового экземпляра MessageQueue класса. Unlike Purge, Create(String) and Delete(String) are static members, so you can call them without creating a new instance of the MessageQueue class.

Свойство объекта можно задать MessageQueue Path с помощью одного из трех имен: понятное имя, FormatName или Label . You can set the MessageQueue object’s Path property with one of three names: the friendly name, the FormatName, or the Label. Понятное имя, определяемое MachineName свойствами очереди и QueueName , предназначено MachineName \ QueueName для общей очереди и MachineName \ Private$ \ QueueName для частной очереди. The friendly name, which is defined by the queue’s MachineName and QueueName properties, is MachineName\QueueName for a public queue, and MachineName\ Private$ \QueueName for a private queue. FormatNameСвойство разрешает автономный доступ к очередям сообщений. The FormatName property allows offline access to message queues. Наконец, можно использовать свойство очереди, Label чтобы задать значение очереди Path . Lastly, you can use the queue’s Label property to set the queue’s Path.

Список начальных значений свойств для экземпляра MessageQueue см. в разделе MessageQueue конструктор. For a list of initial property values for an instance of MessageQueue, see the MessageQueue constructor.

Конструкторы

Инициализирует новый экземпляр класса MessageQueue. Initializes a new instance of the MessageQueue class. После того как конструктор без параметров инициализирует новый экземпляр, необходимо задать свойство Path экземпляра, прежде чем можно будет использовать этот экземпляр. After the parameterless constructor initializes the new instance, you must set the instance’s Path property before you can use the instance.

Инициализирует новый экземпляр класса MessageQueue, который ссылается на очередь MSMQ по указанному пути. Initializes a new instance of the MessageQueue class that references the Message Queuing queue at the specified path.

Инициализирует новый экземпляр класса MessageQueue, который ссылается на очередь MSMQ по указанному пути и с указанным ограничением доступа на чтение. Initializes a new instance of the MessageQueue class that references the Message Queuing queue at the specified path and with the specified read-access restriction.

Инициализирует новый экземпляр класса MessageQueue. Initializes a new instance of the MessageQueue class.

Инициализирует новый экземпляр класса MessageQueue. Initializes a new instance of the MessageQueue class.

Инициализирует новый экземпляр класса MessageQueue. Initializes a new instance of the MessageQueue class.

Указывает, что для очереди нет ограничений по размеру. Specifies that no size restriction exists for a queue.

Указывает, что для методов считывания и получения сообщений не существует тайм-аута. Specifies that no time-out exists for methods that peek or receive messages.

Свойства

Получает значение, указывающее режим доступа для очереди. Gets a value that indicates the access mode for the queue.

Получает или задает значение, показывающее, принимает ли очередь только сообщения, прошедшие проверку подлинности. Gets or sets a value that indicates whether the queue accepts only authenticated messages.

Получает или задает базовый приоритет, используемый службой очереди сообщений для маршрутизации сообщений общей очереди по сети. Gets or sets the base priority Message Queuing uses to route a public queue’s messages over the network.

Возвращает значение, показывающее, может ли компонент вызывать событие. Gets a value indicating whether the component can raise an event.

(Унаследовано от Component) CanRead

Получает значение, указывающее, может ли быть прочитан объект MessageQueue. Gets a value that indicates whether the MessageQueue can be read.

Получает значение, указывающее, может ли быть выполнена запись в MessageQueue. Gets a value that indicates whether the MessageQueue can be written to.

Возвращает или задает категорию очереди. Gets or sets the queue category.

Возвращает объект IContainer, который содержит коллекцию Component. Gets the IContainer that contains the Component.

(Унаследовано от Component) CreateTime

Получает время и дату создания очереди в службе очереди сообщений. Gets the time and date that the queue was created in Message Queuing.

Получает или задает значения свойств сообщения, которые будут использоваться по умолчанию, когда приложение будет отправлять сообщения в очередь. Gets or sets the message property values to be used by default when the application sends messages to the queue.

Получает или задает значение, показывающее, имеет ли этот объект MessageQueue монопольный доступ на получение сообщений из очереди сообщений. Gets or sets a value that indicates whether this MessageQueue has exclusive access to receive messages from the Message Queuing queue.

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component) EnableConnectionCache

Получает или задает значение, указывающее, будет ли приложение поддерживать кэш подключений. Gets or sets a value that indicates whether a cache of connections will be maintained by the application.

Получает или задает значение, указывающее, будет ли очередь принимать только неконфиденциальные (незашифрованные) сообщения. Gets or sets a value that indicates whether the queue accepts only non-private (non-encrypted) messages.

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component) FormatName

Получает уникальное имя очереди, созданное службой очереди сообщений в момент создания очереди. Gets the unique queue name that Message Queuing generated at the time of the queue’s creation.

Получает или задает модуль форматирования, используемый для сериализации объекта в текст сообщения или десериализации из текста сообщения, прочитанного из очереди или записанного в очередь. Gets or sets the formatter used to serialize an object into or deserialize an object from the body of a message read from or written to the queue.

Получает уникальный идентификатор очереди сообщений. Gets the unique Message Queuing identifier of the queue.

Получает или задает описание очереди. Gets or sets the queue description.

Получает время последнего изменения свойств очереди. Gets the last time the properties of a queue were modified.

Получает или задает имя компьютера, на котором расположена очередь Message Queuing. Gets or sets the name of the computer where the Message Queuing queue is located.

Получает или задает максимальный размер очереди журнала. Gets or sets the maximum size of the journal queue.

Получает или задает максимальный размер очереди. Gets or sets the maximum size of the queue.

Получает или задает фильтр свойств для получения и считывания сообщений. Gets or sets the property filter for receiving or peeking messages.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Получает или задает адрес многоадресной рассылки, связанный с данной очередью. Gets or sets the multicast address associated with the queue.

Получает или задает путь очереди. Gets or sets the queue’s path. После задания свойства Path объект MessageQueue будет указывать на новую очередь. Setting the Path causes the MessageQueue to point to a new queue.

Получает или задает понятное имя, определяющее очередь. Gets or sets the friendly name that identifies the queue.

Получает собственный дескриптор, предназначенный для чтения сообщений из очереди сообщений. Gets the native handle used to read messages from the message queue.

Получает или задает ISite объекта Component. Gets or sets the ISite of the Component.

(Унаследовано от Component) SynchronizingObject

Получает или задает объект, который используется для маршалинга вызовов обработчика событий, возникающих в результате наступления события ReceiveCompleted или события PeekCompleted. Gets or sets the object that marshals the event-handler call resulting from a ReceiveCompleted or PeekCompleted event.

Получает значение, указывающее, принимает ли очередь только транзакции. Gets a value that indicates whether the queue accepts only transactions.

Получает или задает значение, указывающее, должны ли полученные сообщения копироваться в очередь журнала. Gets or sets a value that indicates whether received messages are copied to the journal queue.

Получает собственный дескриптор, который используется для отправки сообщений в очередь сообщений. Gets the native handle used to send messages to the message queue.

Методы

Инициирует асинхронную операцию быстрого редактирования без времени ожидания. Операция не завершается, пока сообщение не станет доступным в очереди. Initiates an asynchronous peek operation that has no time-out. The operation is not complete until a message becomes available in the queue.

Инициирует асинхронную операцию быстрого редактирования с заданным временем ожидания. Операция не завершится, пока сообщение не станет доступным в очереди или не истечет время ожидания. Initiates an asynchronous peek operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию считывания, которая имеет заданный тайм-аут и использует заданный курсор, заданную операцию считывания и заданный объект состояния. Initiates an asynchronous peek operation that has a specified time-out and that uses a specified cursor, a specified peek action, and a specified state object. Объект состояния предоставляет связанные сведения в течение всего времени выполнения операции. The state object provides associated information throughout the lifetime of the operation. Посредством обратного вызова эта перегрузка получает уведомление об отличительных особенностях обработчика событий для операции. This overload receives notification, through a callback, of the identity of the event handler for the operation. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию считывания с указанным тайм-аутом и заданным объектом состояния, который предоставляет связанные данные в течение всего времени выполнения операции. Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation’s lifetime. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию считывания с указанным тайм-аутом и заданным объектом состояния, который предоставляет связанные данные в течение всего времени выполнения операции. Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation’s lifetime. Посредством обратного вызова эта перегрузка получает уведомление об отличительных особенностях обработчика событий для операции. This overload receives notification, through a callback, of the identity of the event handler for the operation. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию получения без времени ожидания. Операция не завершается, пока сообщение не станет доступным в очереди. Initiates an asynchronous receive operation that has no time-out. The operation is not complete until a message becomes available in the queue.

Инициирует асинхронную операцию получения с заданным временем ожидания. Операция не завершится, пока сообщение не станет доступным в очереди или не истечет время ожидания. Initiates an asynchronous receive operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию получения, которая имеет заданный тайм-аут и использует заданный курсор и заданный объект состояния. Initiates an asynchronous receive operation that has a specified time-out and uses a specified cursor and a specified state object. Объект состояния предоставляет связанные сведения в течение всего времени выполнения операции. The state object provides associated information throughout the lifetime of the operation. Посредством обратного вызова эта перегрузка получает уведомление об отличительных особенностях обработчика событий для операции. This overload receives notification, through a callback, of the identity of the event handler for the operation. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию получения с указанным тайм-аутом и заданным объектом состояния, который предоставляет связанные данные в течение всего времени выполнения операции. Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation’s lifetime. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Инициирует асинхронную операцию получения с указанным тайм-аутом и заданным объектом состояния, который предоставляет связанные данные в течение всего времени выполнения операции. Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation’s lifetime. Посредством обратного вызова эта перегрузка получает уведомление об отличительных особенностях обработчика событий для операции. This overload receives notification, through a callback, of the identity of the event handler for the operation. Операция остается незавершенной, пока сообщение не станет доступным в очереди или пока не истечет время ожидания. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Очищает кэш подключений. Clears the connection cache.

Освобождает все ресурсы, выделенные классом MessageQueue. Frees all resources allocated by the MessageQueue.

Создает нетранзакционную очередь сообщений по указанному пути. Creates a non-transactional Message Queuing queue at the specified path.

Создает транзакционную или нетранзакционную очередь сообщений по указанному пути. Creates a transactional or non-transactional Message Queuing queue at the specified path.

Создает новый объект Cursor для текущей очереди сообщений. Creates a new Cursor for the current message queue.

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject) Delete(String)

Удаляет очередь с сервера очереди сообщений. Deletes a queue on a Message Queuing server.

Освобождает все ресурсы, занятые модулем Component. Releases all resources used by the Component.

(Унаследовано от Component) Dispose(Boolean)

Уничтожает ресурсы (кроме памяти), используемые классом MessageQueue. Disposes of the resources (other than memory) used by the MessageQueue.

Завершает указанную асинхронную операцию считывания. Completes the specified asynchronous peek operation.

Завершает указанную асинхронную операцию получения. Completes the specified asynchronous receive operation.

Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Унаследовано от Object) Exists(String)

Определяет, существует ли по указанному пути очередь сообщений. Determines whether a Message Queuing queue exists at the specified path.

Возвращает все сообщения из очереди. Returns all the messages that are in the queue.

Перечисляет сообщения в очереди. Enumerates the messages in a queue. Параметр GetEnumerator() использовать не рекомендуется. GetEnumerator() is deprecated. Вместо него следует использовать метод GetMessageEnumerator2(). GetMessageEnumerator2() should be used instead.

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Унаследовано от Object) GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject) GetMachineId(String)

Получает идентификатор компьютера, на котором расположена очередь, на которую ссылается этот класс MessageQueue. Gets the identifier of the computer on which the queue referenced by this MessageQueue is located.

Создает объект перечислителя для всех сообщений очереди. Creates an enumerator object for all the messages in the queue. Параметр GetMessageEnumerator() использовать не рекомендуется. GetMessageEnumerator() is deprecated. Вместо него следует использовать метод GetMessageEnumerator2(). GetMessageEnumerator2() should be used instead.

Создает объект перечислителя для всех сообщений очереди. Creates an enumerator object for all the messages in the queue.

Обеспечивает семантику курсора последовательного доступа для перечисления во всех общих очередях сети. Provides forward-only cursor semantics to enumerate through all public queues on the network.

Обеспечивает семантику курсора последовательного доступа для перечисления во всех общих очередях сети, удовлетворяющих указанным критериям. Provides forward-only cursor semantics to enumerate through all public queues on the network that meet the specified criteria.

Извлекает все частные очереди на указанном компьютере. Retrieves all the private queues on the specified computer.

Извлекает все общие очереди сети. Retrieves all the public queues on the network.

Извлекает все общие очереди сети, удовлетворяющие указанным критериям. Retrieves all the public queues on the network that meet the specified criteria.

Извлекает все общие очереди сети, принадлежащие к указанной категории. Retrieves all the public queues on the network that belong to the specified category.

Извлекает все общие очереди сети с указанной меткой. Retrieves all the public queues on the network that carry the specified label.

Извлекает все общие очереди, находящиеся на указанном компьютере. Retrieves all the public queues that reside on the specified computer.

Извлекает контекст безопасности, который служба MSMQ связывает с текущим пользователем (удостоверением потока) на момент этого вызова. Retrieves the security context that MSMQ associates with the current user (thread identity) at the time of this call.

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject. Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject) Peek()

Возвращает, не удаляя (считывает), первое сообщение в очереди, на которую ссылается этот объект MessageQueue. Returns without removing (peeks) the first message in the queue referenced by this MessageQueue. Метод Peek() является синхронным, поэтому он блокирует текущий поток до тех пор, пока сообщение не станет доступным. The Peek() method is synchronous, so it blocks the current thread until a message becomes available.

Возвращает, не удаляя (считывает), первое сообщение в очереди, на которую ссылается этот объект MessageQueue. Returns without removing (peeks) the first message in the queue referenced by this MessageQueue. Метод Peek() является синхронным, поэтому он блокирует текущий поток до тех пор, пока сообщение не станет доступным или пока не истечет заданный тайм-аут. The Peek() method is synchronous, so it blocks the current thread until a message becomes available or the specified time-out occurs.

Возвращает, не удаляя (считывает), текущее или следующее сообщение в очереди, используя заданный курсор. Returns without removing (peeks) the current or next message in the queue, using the specified cursor. Метод Peek() является синхронным, поэтому он блокирует текущий поток до тех пор, пока сообщение не станет доступным или пока не истечет заданный тайм-аут. The Peek() method is synchronous, so it blocks the current thread until a message becomes available or the specified time-out occurs.

Считывает сообщение, которое соответствует заданному идентификатору корреляции, и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором корреляции. Peeks the message that matches the given correlation identifier and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

Считывает сообщение, которое соответствует заданному идентификатору корреляции и ожидает, пока в очереди не появится сообщение с указанным идентификатором корреляции или пока не истечет тайм-аут. Peeks the message that matches the given correlation identifier and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

Считывает сообщение, идентификатор которого соответствует параметру id . Peeks the message whose message identifier matches the id parameter.

Считывает сообщение, идентификатор которого соответствует параметру id . Peeks the message whose message identifier matches the id parameter. Ожидает, пока сообщение не появится в очереди, или не возникнет тайм-аут. Waits until the message appears in the queue or a time-out occurs.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Считывает сообщение, соответствующее заданному идентификатору просмотра, из нетранзакционной очереди. Peeks at the message that matches the given lookup identifier from a non-transactional queue.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Считывает конкретное сообщение из очереди. Peeks at a specific message from the queue. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

Удаляет все сообщения, содержащиеся в очереди. Deletes all the messages contained in the queue.

Получает первое доступное в очереди сообщение, на которое ссылается объект MessageQueue. Receives the first message available in the queue referenced by the MessageQueue. Этот вызов является синхронным и он блокирует текущий поток выполнения, пока сообщение не станет доступным. This call is synchronous, and blocks the current thread of execution until a message is available.

Получает первое доступное в транзакционной очереди сообщение, на которое ссылается объект MessageQueue. Receives the first message available in the transactional queue referenced by the MessageQueue. Этот вызов является синхронным и он блокирует текущий поток выполнения, пока сообщение не станет доступным. This call is synchronous, and blocks the current thread of execution until a message is available.

Получает первое доступное в очереди сообщение, на которое ссылается объект MessageQueue. Receives the first message available in the queue referenced by the MessageQueue. Этот вызов является синхронным и он блокирует текущий поток выполнения, пока сообщение не станет доступным. This call is synchronous, and blocks the current thread of execution until a message is available.

Получает первое сообщение, доступное в очереди, на которую ссылается объект MessageQueue, и ожидает пока в очереди не появится сообщение или пока не истечет тайм-аут. Receives the first message available in the queue referenced by the MessageQueue and waits until either a message is available in the queue, or the time-out expires.

Получает текущее сообщение в очереди, используя заданный курсор. Receives the current message in the queue, using a specified cursor. Если доступных сообщений нет, этот метод ожидает, пока не станет доступным сообщение или пока не истечет тайм-аут. If no message is available, this method waits until either a message is available, or the time-out expires.

Получает текущее сообщение в очереди, используя заданный курсор. Receives the current message in the queue, using a specified cursor. Если доступных сообщений нет, этот метод ожидает, пока не станет доступным сообщение или пока не истечет тайм-аут. If no message is available, this method waits until either a message is available, or the time-out expires.

Получает текущее сообщение в очереди, используя заданный курсор. Receives the current message in the queue, using a specified cursor. Если доступных сообщений нет, этот метод ожидает, пока не станет доступным сообщение или пока не истечет тайм-аут. If no message is available, this method waits until either a message is available, or the time-out expires.

Получает первое сообщение, доступное в транзакционной очереди, на которую ссылается объект MessageQueue, и ожидает, пока в очереди не появится сообщение или пока не истечет тайм-аут. Receives the first message available in the transactional queue referenced by the MessageQueue and waits until either a message is available in the queue, or the time-out expires.

Получает первое доступное в очереди сообщение, на которое ссылается объект MessageQueue. Receives the first message available in the queue referenced by the MessageQueue. Данный вызов является синхронным, и он ожидает, пока в очереди не появится сообщение, или пока не истечет тайм-аут. This call is synchronous, and waits until either a message is available in the queue, or the time-out expires.

Получает сообщение, которое соответствует заданному идентификатору корреляции (из нетранзакционной очереди), и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором корреляции. Receives the message that matches the given correlation identifier (from a non-transactional queue) and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору корреляции (из транзакционной очереди), и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором корреляции. Receives the message that matches the given correlation identifier (from a transactional queue) and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору корреляции, и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором корреляции. Receives the message that matches the given correlation identifier and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору корреляции (из нетранзакционной очереди), и ожидает, пока в очереди не появится сообщение с указанным идентификатором корреляции или пока не истечет тайм-аут. Receives the message that matches the given correlation identifier (from a non-transactional queue) and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

Получает сообщение, которое соответствует заданному идентификатору корреляции (из транзакционной очереди), и ожидает, пока в очереди не появится сообщение с указанным идентификатором корреляции или пока не истечет тайм-аут. Receives the message that matches the given correlation identifier (from a transactional queue) and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

Получает сообщение, которое соответствует заданному идентификатору корреляции и ожидает, пока в очереди не появится сообщение с указанным идентификатором корреляции или пока не истечет тайм-аут. Receives the message that matches the given correlation identifier and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

Получает из нетранзакционной очереди сообщение, которое соответствует заданному идентификатору, и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором. Receives the message that matches the given identifier from a non-transactional queue and immediately raises an exception if no message with the specified identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору (из транзакционной очереди), и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором. Receives the message that matches the given identifier (from a transactional queue) and immediately raises an exception if no message with the specified identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору, и сразу инициирует исключение, если в настоящий момент в очереди нет сообщения с указанным идентификатором. Receives the message that matches the given identifier and immediately raises an exception if no message with the specified identifier currently exists in the queue.

Получает сообщение, которое соответствует заданному идентификатору (из нетранзакционной очереди), и ожидает, пока в очереди не появится сообщение с указанным идентификатором, или пока не истечет тайм-аут. Receives the message that matches the given identifier (from a non-transactional queue) and waits until either a message with the specified identifier is available in the queue or the time-out expires.

Получает сообщение, которое соответствует заданному идентификатору (из транзакционной очереди), и ожидает, пока в очереди не появится сообщение с указанным идентификатором, или пока не истечет тайм-аут. Receives the message that matches the given identifier (from a transactional queue) and waits until either a message with the specified identifier is available in the queue or the time-out expires.

Получает сообщение, которое соответствует заданному идентификатору, и ожидает, пока в очереди не появится сообщение с указанным идентификатором, или пока не истечет тайм-аут. Receives the message that matches the given identifier and waits until either a message with the specified identifier is available in the queue or the time-out expires.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Получает сообщение, соответствующее заданному идентификатору просмотра, из нетранзакционной очереди. Receives the message that matches the given lookup identifier from a non-transactional queue.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Получает конкретное сообщение из транзакционной очереди. Receives a specific message from a transactional queue. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

Представлено в MSMQ 3.0. Introduced in MSMQ 3.0. Получает из очереди определенное сообщение, используя заданный контекст транзакции. Receives a specific message from the queue, using the specified transaction context. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

Обновляет свойства, представленные объектом MessageQueue для отражения текущего состояния ресурса. Refreshes the properties presented by the MessageQueue to reflect the current state of the resource.

Присваивает списку разрешений значения по умолчанию операционной системы. Resets the permission list to the operating system’s default values. Удаляет все разрешения очередей, добавленные в список по умолчанию. Removes any queue permissions you have appended to the default list.

Отправляет объект в нетранзакционную очередь, на которую ссылается этот класс MessageQueue. Sends an object to non-transactional queue referenced by this MessageQueue.

Отправляет объект в транзакционную очередь, на которую ссылается этот объект MessageQueue. Sends an object to the transactional queue referenced by this MessageQueue.

Отправляет объект в очередь, на которую ссылается этот объект MessageQueue. Sends an object to the queue referenced by this MessageQueue.

Отправляет объект в нетранзакционную очередь, на которую ссылается этот объект MessageQueue, и задает метку сообщения. Sends an object to the non-transactional queue referenced by this MessageQueue and specifies a label for the message.

Отправляет объект в транзакционную очередь, на которую ссылается этот объект MessageQueue, и задает метку сообщения. Sends an object to the transactional queue referenced by this MessageQueue and specifies a label for the message.

Отправляет объект в очередь, на которую ссылается этот объект MessageQueue, и задает метку сообщения. Sends an object to the queue referenced by this MessageQueue and specifies a label for the message.

Назначает права доступа к очереди на основе содержимого списка управления доступом. Assigns access rights to the queue based on the contents of an access control list.

Назначает права доступа к очереди на основе содержимого элемента управления доступом. Assigns access rights to the queue based on the contents of an access control entry.

Предоставляет компьютеру, группе или пользователю указанные права доступа. Gives a computer, group, or user the specified access rights.

Предоставляет компьютеру, группе или пользователю указанные права доступа указанного типа управления доступом (разрешить, отказать, отозвать или задать). Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

Возвращает объект String, содержащий имя Component, если оно есть. Returns a String containing the name of the Component, if any. Этот метод не следует переопределять. This method should not be overridden.

(Унаследовано от Component)

События

Возникает при удалении компонента путем вызова метода Dispose(). Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component) PeekCompleted

Происходит, когда сообщение читается без удаления из очереди. Occurs when a message is read without being removed from the queue. Это результат асинхронной операции — BeginPeek(). This is a result of the asynchronous operation, BeginPeek().

Происходит, если сообщение было удалено из очереди. Occurs when a message has been removed from the queue. Это событие инициируется асинхронной операцией, BeginReceive(). This event is raised by the asynchronous operation, BeginReceive().

Методы расширения

Приводит элементы объекта IEnumerable к заданному типу. Casts the elements of an IEnumerable to the specified type.

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу. Filters the elements of an IEnumerable based on a specified type.

Позволяет осуществлять параллельный запрос. Enables parallelization of a query.

Преобразовывает коллекцию IEnumerable в объект IQueryable. Converts an IEnumerable to an IQueryable.

Применяется к

Потокобезопасность

Только GetAllMessages() метод является потокобезопасным. Only the GetAllMessages() method is thread safe.