<Netmsmqbinding>

Статья
04/11/2023

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

<настройка>
  <system.serviceModel>
    <Привязки>
      <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, для привязок и поведений не требуется иметь имя. Дополнительные сведения о конфигурации по умолчанию и безымяных привязках и поведении см. в разделах Упрощенная конфигурация и Упрощенная конфигурация для служб WCF.
`openTimeout`	Значение TimeSpan, которое задает длительность времени ожидания для завершения операции открытия. Это значение должно быть больше или равно Zero. Значение по умолчанию - 00:01:00.
`QueueTransferProtocol`	Допустимое значение QueueTransferProtocol, задающее поставленный в очередь транспорт коммуникационного канала, используемый этой привязкой. MSMQ не поддерживает адресацию Active Directory при использовании протокола надежного обмена сообщениями SOAP. Поэтому не следует задавать этому атрибуту значение `Srmp` или , если `useActiveDirectory` атрибут имеет значение `trueSrmps` .
`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`. Использующие очереди приложения, которым нужно хранить запись сообщений, покинувших очередь исходящих сообщений компьютера, могут копировать сообщения в журнал компьютера. После того как сообщение покинуло очередь исходящих сообщений, и появилось подтверждение приема сообщения конечным компьютером, в очереди системного журнала компьютера-отправителя сохраняется копия сообщения.

Дочерние элементы

Элемент	Описание
<readerQuotas>	Определяет ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с использованием этой привязки. Это элемент типа XmlDictionaryReaderQuotasElement.
<Безопасности>	Определяет параметры безопасности привязки. Это элемент типа NetMsmqSecurityElement.

Родительские элементы

Элемент	Описание
<Привязки>	Этот элемент содержит коллекцию стандартных и пользовательских привязок.

Привязка netMsmqBinding обеспечивает поддержку организации очереди, используя очередь сообщений (MSMQ) как транспорт, и включает поддержку слабо связанных приложений, изоляции сбоев, распределения нагрузки, а также операций при отсутствии подключения к сети. Описание этих функций см. в разделе Очереди в 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>
        </binding>
      </netMsmqBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Поделиться через