Message.SentTime Property (System.Messaging)

.NET Framework Class Library

Message..::.SentTime Property

Gets the date and time on the sending computer that the message was sent by the source queue manager.

Namespace: System.Messaging
Assembly: System.Messaging (in System.Messaging.dll)

Syntax

Visual Basic (Declaration)

<MessagingDescriptionAttribute("MsgSentTime")> _
Public ReadOnly Property SentTime As DateTime

Visual Basic (Usage)

Dim instance As Message
Dim value As DateTime

value = instance.SentTime

[MessagingDescriptionAttribute("MsgSentTime")]
public DateTime SentTime { get; }

Visual C++

[MessagingDescriptionAttribute(L"MsgSentTime")]
public:
property DateTime SentTime {
    DateTime get ();
}

JScript

public function get SentTime () : DateTime

Property Value

Type: System..::.DateTime
A DateTime that represents the time the message was sent.

Exceptions

Exception	Condition
InvalidOperationException	The message has not been sent. This property can only be read on messages retrieved from a queue. -or- The message queue is filtered to ignore the SentTime property.

Exception

Condition

InvalidOperationException

The message has not been sent. This property can only be read on messages retrieved from a queue.

-or-

The message queue is filtered to ignore the SentTime property.

Remarks

The SentTime property is adjusted to the local time of the computer on which this instance of the Message class was created. This time zone could be different from those of the source and destination queues.

Examples

The following code example displays the value of a message's SentTime property.

// Display the value of the message's SentTime property.
// To view this property value, the queue's
// MessageReadPropertyFilter.SentTime property must be set to
// true before the message is received.
Console.WriteLine("Time sent from source queue: {0}",
    orderMessage.SentTime.ToString());

Visual C++

// Display the value of the message's SentTime property.
// To view this property value, the queue's
// MessageReadPropertyFilter.SentTime property must be set to
// true before the message is received.
Console::WriteLine("Time sent from source queue: {0}",
    orderMessage->SentTime.ToString());

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0

Reference

Message Class

Message Members

System.Messaging Namespace