MsmqElementBase.ExactlyOnce Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает логическое значение, указывающее, доставляются ли сообщения, обрабатываемые этой привязкой, только один раз.
public:
property bool ExactlyOnce { bool get(); void set(bool value); };
[System.Configuration.ConfigurationProperty("exactlyOnce", DefaultValue=true)]
public bool ExactlyOnce { get; set; }
[<System.Configuration.ConfigurationProperty("exactlyOnce", DefaultValue=true)>]
member this.ExactlyOnce : bool with get, set
Public Property ExactlyOnce As Boolean
Значение свойства
Значение true
, если сообщения, обрабатываемые этой привязкой, будут доставляться только один раз; в противном случае — значение false
. Значение по умолчанию — true
.
- Атрибуты
Комментарии
Сообщение может быть отправлено с гарантией или без нее. Гарантия позволяет приложению обеспечить достижение отправленным сообщением очереди полученных сообщений, а если этого не произошло, приложение может определить этот факт, считав данные из очереди недоставленных сообщений.
Отправляемые сообщения, свойству ExactlyOnce которых присвоено значение true
, должны помещаться только в очередь транзакционных сообщений.
ExactlyOnce, если задано значение true
, указывает, что очередь сообщений (также известная как MSMQ) гарантирует, что отправленное сообщение будет доставлено в очередь получающих сообщений только один раз, а в случае сбоя доставки сообщение отправляется в очередь недоставленных сообщений.
Для сообщений, которым требуется, чтобы свойство ExactlyOnce имело значение false
, свойству DeadLetterQueue по умолчанию присваивается значение null
.
Для сообщений, для которых требуется ExactlyOnce значение true
, DeadLetterQueue свойство по умолчанию имеет значение транзакционной системной очереди недоставленных сообщений в очереди сообщений.