MsmqElementBase.TimeToLive Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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.

Namespace:   System.ServiceModel.Configuration
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

[ConfigurationPropertyAttribute("timeToLive", DefaultValue = "1.00:00:00")]
public TimeSpan TimeToLive { get; set; }

Property Value

Type: System.TimeSpan

The TimeSpan that indicates how long the messages can be in the queue before they expire. The default value is one day (01:00:00:00).

The TimeToLive 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 consumed by the receiving application within the time interval specified is said to be 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 DeadLetterQueue property or to the appropriate default, based on assurances.

.NET Framework
Available since 3.0
Return to top