MsmqBindingBase.ExactlyOnce Свойство
Определение
Возвращает или задает значение, указывающее, принимаются ли сообщения, обрабатываемые этой привязкой, только один раз.Gets or sets a value that indicates whether messages processed by this binding are received exactly once.
public:
property bool ExactlyOnce { bool get(); void set(bool value); };
public bool ExactlyOnce { get; set; }
member this.ExactlyOnce : bool with get, set
Public Property ExactlyOnce As Boolean
Значение свойства
Значение true
, если сообщения, обрабатываемые этой привязкой, принимаются только один раз; в противном случае — значение false
.true
if messages processed by this binding are received exactly once; otherwise, false
. Значение по умолчанию — true
.The default is true
.
Комментарии
Сообщение может быть отправлено с гарантией или без нее.A message can be sent with or without assurances. Гарантия позволяет приложению обеспечить достижение отправленным сообщением очереди полученных сообщений, а если этого не произошло, приложение может определить этот факт, считав данные из очереди недоставленных сообщений.An assurance enables an application to ensure that a sent message reached the receiving message queue, or if it did not, the application can determine this by reading the dead-letter queue.
Сообщения, отправленные со свойством ExactlyOnce, имеющим значение true
, должны отправляться только в транзакционную очередь.Messages sent with ExactlyOnce set to true
must be sent to a transactional queue only.
Если свойству ExactlyOnce присвоено значение true
, это означает, что очередь сообщений (MSMQ) гарантированно поместит отправленное сообщение в очередь полученных сообщений один и только один раз.ExactlyOnce, when set to true
, indicates that Message Queuing (MSMQ) ensures that a sent message is delivered to the receiving message queue once and only once. В случае сбоя доставки сообщение отправляется в очередь недоставленных сообщений.If delivery fails, the message is sent to the dead-letter queue.
Для сообщений, которым требуется, чтобы свойство ExactlyOnce имело значение false
, свойству DeadLetterQueue по умолчанию присваивается значение null
.For messages that require ExactlyOnce to be false
, the DeadLetterQueue property defaults to null
.
Для сообщений, которым требуется, чтобы свойство ExactlyOnce имело значение true
, свойству DeadLetterQueue по умолчанию присваивается используемая в MSMQ системная очередь транзакционных сообщений.For messages that require ExactlyOnce to be true
, the DeadLetterQueue property defaults to a transactional system-wide dead-letter queue in MSMQ.