<netMsmqBinding>
Определяет поставленную в очередь привязку, пригодную для обеспечения связи между компьютерами.
Иерархия схемы
<system.serviceModel>
<bindings>
<netMsmqBinding>
Синтаксис
<netMsmqBinding>
<binding
closeTimeout="TimeSpan"
customDeadLetterQueue="Uri"
deadLetterQueue="Uri"
durable="Boolean"
exactlyOnce="Boolean"
maxBufferPoolSize="Integer"
maxReceivedMessageSize"Integer"
maxRetryCycles="Integer"
name="string"
openTimeout="TimeSpan"
poisonMessageHandling="Disabled/EnabledIfSupported"
queueTransferProtocol="Native/Srmp/SrmpSecure"
receiveErrorHandling="Drop/Fault/Move/Reject"
receiveTimeout="TimeSpan"
receiveRetryCount="Integer"
rejectAfterLastRetry="Boolean"
retryCycleDelay="TimeSpan"
sendTimeout="TimeSpan"
timeToLive="TimeSpan"
useActiveDirectory="Boolean"
useMsmqTracing="Boolean
useSourceJournal="Boolean"
<security>
<message
algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
clientCredentialType="None/Windows/UserName/Certificate/InfoCard "/>
<transport msmqAuthenticationMode="None/WindowsDomain/Certificate"
msmqEncryptionAlgorithm="RC4Stream/AES"
msmqProtectionLevel="None/Sign/EncryptAndSign"
msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />
</security>
<readerQuotas maxArrayLength="Integer" maxBytesPerRead="Integer" maxDepth="Integer" maxNameTableCharCount="Integer" maxStringContentLength="Integer" /> </binding></netMsmqBinding>
Атрибуты и элементы
В следующих разделах описываются атрибуты, дочерние и родительские элементы.
Атрибуты
| Атрибут | Описание |
|---|---|
closeTimeout |
Значение TimeSpan, которое задает длительность времени ожидания для завершения операции закрытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00. |
customDeadLetterQueue |
Универсальный код ресурса (URI), который указывает местоположение очереди недоставленных сообщений для каждого приложения, куда помещаются сообщения с истекшим сроком или сообщения, которые не удалось передать или доставить. Очередью недоставленных сообщений является очередь в диспетчере очередей отправившего приложения для сообщений с истекшим сроком, которые не удалось доставить. Универсальный код ресурса (URI), заданный с помощью CustomDeadLetterQueue, должен использовать схему net.msmq. |
deadLetterQueue |
Значение DeadLetterQueue, определяющее, какой тип очереди недоставленных сообщений следует использовать, если таковые имеются. Очередь недоставленных сообщений — это место, куда будут помещаться сообщения, доставка которых приложению завершилась неудачей. Для сообщений с требованием гарантии доставки exactlyOnce (т.е. если для атрибута exactlyOnce установлено значение true) в качестве этого атрибута в рамках всей системы по умолчанию устанавливается очередь недоставленных транзакционных сообщений в MSMQ. Для сообщений, которые не требуют гарантии, по умолчанию этот атрибут имеет значение null. |
durable |
Логическое значение, указывающее, является ли сообщение в очереди постоянным или переменным. Постоянное сообщение сохраняется после сбоя диспетчера очередей, а переменное сообщение — нет. Переменные сообщения используются, если для приложений требуются небольшие задержки, и приложения допускают периодические потери сообщений. Если атрибут exactlyOnce имеет значение true, сообщения должны быть постоянными. Значение по умолчанию — true. |
exactlyOnce |
Логическое значение, указывающее, доставляется ли каждое сообщение, обрабатываемое этой привязкой, только один раз. Затем отправитель оповещается об ошибках доставки. Если durable имеет значение false, этот атрибут не учитывается и сообщения пересылаются без гарантии доставки. Значение по умолчанию — true. Дополнительные сведения см. в разделе ExactlyOnce. |
maxBufferPoolSize |
Целое число, задающее максимальный размер буферного пула для этой привязки. Значение по умолчанию — 8. |
maxReceivedMessageSize |
Положительное целое число, определяющее максимальный размер сообщения (в байтах), включая заголовки, которое обрабатывается этой привязкой. Отправитель сообщения, превышающего это ограничение, получит ошибку SOAP. Получатель отклоняет сообщение и создает запись о событии в журнале трассировки. Значение по умолчанию — 65536. Это ограничение размера сообщения предназначено для уменьшения уязвимости к атакам типа «отказ в обслуживании» (DoS). |
maxRetryCycles |
Целое число, указывающее количество циклов повтора, используемых функцией обнаружения подозрительных сообщений. Сообщение становится подозрительным, если попытки доставки во всех циклах закончились неудачей. Значение по умолчанию — 3. Дополнительные сведения см. в разделе MaxRetryCycles. |
name |
Обязательный атрибут. Строка, содержащая имя конфигурации привязки. Это значение должно быть уникальным, поскольку оно используется в качестве идентификатора привязки. Начиная с версии .NET Framework 4 для привязок и поведений необязательно задавать имена. Дополнительные сведения о конфигурации по умолчанию и о безымянных привязках и поведениях см. в разделах Simplified Configuration и Simplified Configuration for WCF Services. |
openTimeout |
Значение TimeSpan, которое задает длительность времени ожидания для завершения операции открытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00. |
QueueTransferProtocol |
Допустимое значение QueueTransferProtocol, задающее поставленный в очередь транспорт коммуникационного канала, используемый этой привязкой. MSMQ не поддерживает адресацию Active Directory при использовании протокола надежного обмена сообщениями SOAP. Поэтому данному атрибуту нельзя присваивать значение Srmp или Srmps, если атрибут useActiveDirectory имеет значение true. |
receiveErrorHandling |
Значение ReceiveErrorHandling, указывающее, каким образом будут обрабатываться подозрительные сообщения и сообщения, которые не удалось доставить. |
receiveRetryCount |
Целое число, задающее максимальное число попыток отправки сообщения диспетчером очереди, после которого сообщение передается в очередь повторного выполнения. |
receiveTimeout |
Значение TimeSpan, которое задает длительность времени ожидания для завершения операции получения. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:10:00. |
retryCycleDelay |
Значение TimeSpan, которое задает временную задержку между циклами повторов при попытке доставить сообщение, которое не удалось доставить сразу. Значение определяет только минимальное время ожидания, поскольку фактическое время ожидания может быть больше. Значение по умолчанию — 00:10:00. Дополнительные сведения см. в разделе RetryCycleDelay. |
sendTimeout |
Значение TimeSpan, которое задает длительность времени ожидания для завершения операции отправки. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00. |
timeToLive |
Значение TimeSpan, указывающее, как долго сообщения остаются действительными до истечения их срока, после чего они переводятся в очередь недоставленных сообщений. Значение по умолчанию — 1.00:00:00. Этот атрибут устанавливается для предотвращения устаревания срочных сообщений до их обработки получающими приложениями. Сообщение в очереди, которое не поступает в принимающее приложение в пределах заданного интервала времени, считается устаревшим. Устаревшие сообщения отправляются в специальную очередь, называемую очередью недоставленных сообщений. Расположение очереди недоставленных сообщений задается атрибутом DeadLetterQueue, или оно устанавливается на основании гарантий в соответствующее значение по умолчанию. |
usingActiveDirectory |
Логическое значение, определяющее, должны ли адреса очередей преобразовываться с использованием Active Directory. Адреса очередей MSMQ могут включать имена пути или непосредственные имена форматов. С помощью непосредственного имени формата служба MSMQ разрешает имя компьютера с использованием DNS, NetBIOS или IP-адреса. С помощью имени пути MSMQ разрешает имя компьютера с использованием Active Directory. По умолчанию транспорт очереди Windows Communication Foundation (WCF) преобразует URI очереди сообщений в прямое имя формата. Установив свойство UseActiveDirectory на значение true, приложение может указать, что транспорт в очереди должен разрешать имя компьютера с использованием Active Directory, а не DNS, NetBIOS или IP. |
useMsmqTracing |
Логическое значение, указывающее, должна ли выполняться трассировка сообщений, обрабатываемых этой привязкой. Значение по умолчанию — false. Если трассировка включена, каждый раз, когда сообщение отправляется с компьютера службы очередей или поступает на этот компьютер, создаются сообщения-отчеты, которые затем отправляются в очередь отчетов. |
useSourceJournal |
Логическое значение, которое указывает, должны ли копии сообщений, обрабатываемых этой привязкой, храниться в журнале источников. Значение по умолчанию — false. Использующие очереди приложения, которым нужно хранить запись сообщений, покинувших очередь исходящих сообщений компьютера, могут копировать сообщения в журнал компьютера. После того как сообщение покинуло очередь исходящих сообщений, и появилось подтверждение приема сообщения конечным компьютером, в очереди системного журнала компьютера-отправителя сохраняется копия сообщения. |
Дочерние элементы
| Элемент | Описание |
|---|---|
Определяет ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с использованием этой привязки. Это элемент типа XmlDictionaryReaderQuotasElement. |
|
Определяет параметры безопасности привязки. Это элемент типа NetMsmqSecurityElement. |
Родительские элементы
| Элемент | Описание |
|---|---|
Этот элемент содержит коллекцию стандартных и пользовательских привязок. |
Замечания
Привязка netMsmqBinding обеспечивает поддержку организации очереди, используя очередь сообщений (MSMQ) как транспорт, и включает поддержку слабо связанных приложений, изоляции сбоев, распределения нагрузки, а также операций при отсутствии подключения к сети. Обсуждение этих возможностей см. в разделе Queues in WCF.
Пример
<configuration>
<system.ServiceModel>
<bindings>
<netMsmqBinding>
<binding
closeTimeout="00:00:10"
openTimeout="00:00:20"
receiveTimeout="00:00:30"
sendTimeout="00:00:40"
deadLetterQueue="net.msmq://localhost/blah"
durable="true"
exactlyOnce="true"
maxReceivedMessageSize="1000"
maxRetries="11"
maxRetryCycles="12"
poisonMessageHandling="Disabled"
rejectAfterLastRetry="false"
retryCycleDelay="00:05:55"
timeToLive="00:11:11"
sourceJournal="true"
useMsmqTracing="true"
useActiveDirectory="true">
<security>
<message clientCredentialType="Windows" />
</security>
</netMsmqBinding>
</bindings>
</system.ServiceModel>
</configuration>
См. также
Справочник
NetMsmqBinding
NetMsmqBindingElement
Основные понятия
Другие ресурсы
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients
Queues in WCF