System.ServiceModel 4.0.0.0 System.ServiceModel.Configuration.StandardBindingElement

This class contains settings required to configure a binding based on Message Queuing (also known as MSMQ).

Provides the base class with members common to the and classes.

- Constructor
  4.0.0.0
  To be added.

  Initializes a new instance of the class.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("customDeadLetterQueue", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Uri To be added.

  A dead-letter queue is a queue managed by the sending application's queue manager that stores messages that have failed to be delivered or have expired. The CustomDeadLetterQueue property allows you to specify a custom dead-letter queue rather than using the default system-wide, dead-letter queue.

  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 that identifies a custom dead-letter queue where expired messages or messages that failed to be delivered are sent.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("deadLetterQueue", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.ServiceModel.DeadLetterQueue To be added.

  The dead-letter queue is a queue managed by the sending application's queue manager that stores messages that have failed to be delivered or have expired. 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 the setting for this binding.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("durable", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  If this property is set to true, messages are durable; otherwise, messages are volatile. Durable messages are not lost if the queue manager crashes. The default value for this property is true. When exactly-once assurances are required ( is set to true), this property must be set to true.

  Gets or sets a value that specifies whether messages sent with this binding are durable or volatile.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("exactlyOnce", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  , when set to true, indicates that Message Queuing (also known as 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 depending on the DeadLetterQueue property setting. Setting to true requires the queue to be transactional.

  Gets or sets a value that specifies whether messages sent with this binding have exactly-once assurances.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("maxReceivedMessageSize", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Configuration.LongValidator(ExcludeRange=false, MaxValue=9223372036854775807, MinValue=0)
  System.Int64 To be added.

  If an incoming message is larger than , the message is dropped.

  Gets or sets a value that indicates the maximum size, in bytes, allowed for a message.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("maxRetryCycles", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Configuration.IntegerValidator(ExcludeRange=false, MaxValue=2147483647, MinValue=0)
  System.Int32 To be added.

  A retry cycle is when a message is transferred from the retry queue to the application queue to attempt delivery to the application. Messages are placed in the retry queue after failing a number of immediate retries as specified by . specifies the number of retry cycles and does not include the initial attempt to send the message. An attempt to deliver a message is made a maximum of (1 + MaxRetryCycles) * (ReceiveRetryCount + 1) times. For example, if ReceiveRetryCount = 0 and MaxRetryCycles is 1, there is a maximum of two attempts to deliver the message. This property is available starting with the wv operating system.

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

- Property
  4.0.0.0
  System.Configuration.ConfigurationPropertyCollection To be added. To be added.

  Gets a instance that contains a collection of objects that can be attributes or objects of this configuration element.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("receiveErrorHandling", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.ServiceModel.ReceiveErrorHandling To be added.

  When this property is set to , the listener is faulted and a (wrapping a ) is traced and thrown. The message is left in the queue and must be removed in a manual way. The contains a that can be used to identify and manually remove the message from the poison-message queue.

  When this property is set to , the offending message is simply dropped.

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

  When this property is set to , the message is moved to the final poison-message subqueue. This option is available only on Message Queuing (also known as MSMQ) 4.0.

  Gets or sets an enumeration value that specifies how poison and messages that cannot be dispatched are handled.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("receiveRetryCount", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Configuration.IntegerValidator(ExcludeRange=false, MaxValue=2147483647, MinValue=0)
  System.Int32 To be added.

  If the maximum number of delivery attempts is reached and the message is not accessed by the application, then the message is sent to a retry queue for redelivery at a later time. The amount of time before the message is transferred back to the sending queue is controlled by . If retry cycles reach the value, then the message 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 retries that the queue manager should attempt if transmission of a message from the application queue to the application fails.

- Property
  4.0.0.0
  System.ComponentModel.TypeConverter(typeof(System.ComponentModel.TimeSpanConverter))
  System.Configuration.ConfigurationProperty("retryCycleDelay", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.TimeSpan To be added.

  A single retry cycle makes repeated attempts to deliver a message to the receiving application (specified by the property). If all attempts fail, the message is placed back in the retry queue. This property specifies how long the message remains in the retry queue before it is transferred to the application queue for another retry cycle. This property is available starting with the wv or later operating systems.

  Gets or sets a value that specifies how long to wait before attempting another retry cycle when attempting to deliver a message that could not be delivered.

- Property
  4.0.0.0
  System.ComponentModel.TypeConverter(typeof(System.ComponentModel.TimeSpanConverter))
  System.Configuration.ConfigurationProperty("timeToLive", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.TimeSpan To be added.

  Queued applications, by design, work in a disconnected manner, so the sending and receiving applications might not be running at the same time. Therefore, a message sent by the sending application might not be processed immediately by the receiving application. Some messages contain information that is valid only for a particular period of time. If this message is not delivered within that period of time, it no longer contains useful information and should be dropped. This property enables you to specify a time limit for how long a message is kept prior to delivery to the application queue. If this time limit elapses prior to the message being delivered to the application queue, the message is placed in the dead-letter queue if one is available (determined by the property); otherwise, if no dead-letter queue is available, the message is dropped.

  Gets or sets a value that specifies how long messages are valid. When this time has elapsed, the message is placed in a dead-letter queue (if available).

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("useMsmqTracing", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  When is set to true, the queued channel uses the Message Queuing built-in message tracing facility. Through this facility, a report message is sent to a specified report queue each time a message enters and leaves a queue manager.

  Gets or sets a value that indicates whether the Message Queuing (also known as MSMQ) built-in message tracing facility is used.

- Property
  4.0.0.0
  System.Configuration.ConfigurationProperty("useSourceJournal", DefaultValue=Mono.Cecil.CustomAttributeArgument, Options=System.Configuration.ConfigurationPropertyOptions.None)
  System.Boolean To be added.

  Queued applications that keep a record of messages that have left the source computer's outgoing queue can have the messages copied to a journal queue. After 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.