System.ServiceModel 4.0.0.0 System.ServiceModel.Channels.Binding System.ServiceModel.Channels.IBindingRuntimePreferences

This abstract class contains properties common to and . All of the fundamental concepts in queuing are displayed in the form of properties.

The base class for and .

- Constructor
  4.0.0.0
  To be added.

  Initializes a new instance of the class.

- Property
  4.0.0.0
  System.Uri To be added.

  The dead-letter queue is a queue on the queue manager of the sending application for expired messages that failed to be delivered.

  The URI that is specified by must use the net.msmq scheme.

  If is set to or , then must be set to null. If is not null, then must be set to .

  Gets or sets a URI that contains the location of the dead-letter queue for each application, where messages that have expired or that have failed transfer or delivery are placed.

- Property
  4.0.0.0
  System.ServiceModel.DeadLetterQueue To be added.

  The dead-letter queue is a queue on the queue manager of the sending application for expired messages that have failed to be delivered. The dead-letter queue enumeration specifies the type of dead-letter queue to use. The values are:

  None: No dead-letter queue is required. If a message fails delivery, no record of it is maintained in the dead-letter queue. This is the default value when is set to false.

  System: The system-wide dead-letter queue is used to record messages that fail delivery. Message Queuing (MSMQ) has a transactional, system, dead-letter queue and a non-transactional, system, dead-letter queue to record messages that fail delivery from transactional and non-transactional queues, respectively. This is the default value when is set to true.

  Custom: The queue specified in the property that is used to record messages that fail delivery.

  The reasons a message can fail to reach the receiving application include:

  A transactional message is sent to a non-transactional queue.

  A non-transactional message is sent to a transactional queue.

  An unauthenticated message is sent to a queue that accepts only authenticated messages.

  An unencrypted message is sent to a queue that accepts only encrypted messages.

  The message expires before the message is delivered to a receiver.

  The message storage quota of the target computer or the storage quota of the destination queue is exceeded, or there is no available storage space on the target computer when the message arrives.

  The sender does not have the access rights required to place the message in the destination queue.

  The digital signature attached to the message is not valid.

  An encrypted message cannot be decrypted by the destination queue manager.

  The destination queue is purged or deleted before the message is retrieved.

  Gets or sets an enumeration value that indicates the type of dead-letter queue to use.

- Property
  4.0.0.0
  System.Boolean To be added.

  A durable message survives when a queue manager stops responding, while a volatile message does not. Volatile messages are useful when applications can tolerate occasional lost messages.

  If is set to true, the messages must be durable.

  Gets or sets a value that indicates whether the messages processed by this binding are durable or volatile.

- Property
  4.0.0.0
  System.Boolean To be added.

  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.

  Messages sent with set to true must be sent to a transactional queue only.

  , 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.

  For messages that require to be false, the property defaults to null.

  For messages that require to be true, the property defaults to a transactional system-wide dead-letter queue in MSMQ.

  Gets or sets a value that indicates whether messages processed by this binding are received exactly once.

- Property
  4.0.0.0
  System.Int64 To be added.

  This bound on message size is intended to limit exposure to Denial of Service (DoS) attacks.

  Gets or sets the maximum size, in bytes, for a message that is processed by this binding.

- Property
  4.0.0.0
  System.Int32 To be added.

  A single retry cycle attempts to deliver a message to an application a specified number of times. The number of attempts made is set by the property. If the application fails to access the message after the specified number of immediate retries, the message is sent to a retry queue. Subsequent retry cycles consist of the message being returned from the retry queue to the application queue to attempt delivery to the application again, after a delay specified by the property. The property specifies the number of retry cycles that the application uses to attempt to deliver the message.

  Gets or sets the maximum number of retry cycles to attempt delivery of messages to the receiving application.

- Property
  4.0.0.0
  System.ServiceModel.ReceiveErrorHandling To be added.

  A message in the queue becomes poisoned if repeated attempts to deliver the message failed. This poison message is eventually handled based on the setting of this property. When this property is set to , the listener is faulted and a is traced and thrown. The poison message is left in the queue and must be removed before more messages can be accessed from the queue. The contains a that can be used to identify and manually remove the poison message from the queue.

  When this property is set to , the poison message is dropped.

  When this property is set to , a negative acknowledgement is sent to the client and the poison message is removed from the queue. This option is available only on Message Queuing 4.0 and requires wv.

  When set to , the poison message is moved to the final poison subqueue. This option is only available on Message Queuing 4.0 and requires wv.

  Gets or sets an enumeration value that specifies how poison messages are handled.

- Property
  4.0.0.0
  System.Int32 To be added.

  If the maximum number of immediate delivery attempts for the message is made and the message is not accessed by the application, then the message is sent to a retry queue to attempt delivery at a later time. If no retry cycles are specified, then the messages is either sent to the poison-message queue, or a negative acknowledgement is sent back to the sender.

  crdefault and .

  Gets or sets the maximum number of immediate delivery attempts on a message that is read from the application queue.

- Property
  4.0.0.0
  System.TimeSpan To be added.

  A single retry cycle attempts to deliver a message to a receiving application a specified number of times. The number of attempts made is specified by the property. If the application fails to access the message after the specified number of immediate retries, the message is sent to a retry queue. Subsequent retry cycles consist of the message being returned from the retry queue to the application queue to attempt delivery to the application again, after a delay specified by the . The number of retry cycles is specified by .

  Gets or sets a value that indicates the time delay between retry cycles when attempting to deliver a message that cannot be delivered immediately.

- Property
  4.0.0.0
  System.String To be added.

  Message Queuing (MSMQ) supports transporting messages between queue managers using both the native MSMQ protocol and the SRMP protocol. Applications that use the queued transport binding can use both of these protocols. The protocol schemes supported by the queued transport binding are net.msmq for the native protocol, net.srmp for the SRMP protocol, and net.srmps for SRMP over HTTPS.

  The supports a single scheme, msmq.formatname, with which the user can specify the format name of the queue directly in the queue address.

  Returns the scheme for this binding.

- Property
  4.0.0.0
  System.Boolean To be added.

  The property is set to true when the is true.

  Gets a value that indicates whether incoming requests can be handled more efficiently synchronously or asynchronously.

- Property
  4.0.0.0
  System.TimeSpan To be added.

  The property is set to ensure that time-sensitive messages do not become stale before they are processed by the receiving applications. A message in a queue that is not accessed by the receiving application within the time interval specified is expired. Expired messages are sent to a special queue called the dead-letter queue. The location of the dead-letter queue is set with the property or to the appropriate default, based on assurances.

  Gets or sets the interval of time that indicates how long the messages processed by this binding can be in the queue before they expire.

- Property
  4.0.0.0
  System.Boolean To be added.

  When tracing is enabled, report messages are created and sent to the report queue each time the message leaves or arrives at a Message Queuing (MSMQ) computer.

  Gets or sets a value that indicates whether messages processed by this binding should be traced.

- Property
  4.0.0.0
  System.Boolean To be added.

  Queued applications that keep a record of messages that have left the computer's outgoing queue can copy the messages to a journal queue. Once a message leaves the outgoing queue and an acknowledgment is received that the message was received on the destination computer, a copy of the message is kept in the sending computer's system journal queue.

  Gets or sets a value that indicates whether copies of messages processed by this binding should be stored in the source journal queue.