Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Message.DigitalSignature Property

Gets or sets the digital signature that Message Queuing uses to authenticate the message.

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

public byte[] DigitalSignature { get; set; }
/** @property */
public byte[] get_DigitalSignature ()

/** @property */
public void set_DigitalSignature (byte[] value)

public function get DigitalSignature () : byte[]

public function set DigitalSignature (value : byte[])

Property Value

An array of byte values that specifies the Message Queuing 1.0 digital signature used to authenticate the message. The default is a zero-length array.

Exception typeCondition


The message queue is filtered to ignore the DigitalSignature property.


The DigitalSignature property is a null reference (Nothing in Visual Basic).

Message Queuing uses the digital signature when authenticating messages that were sent by Message Queuing version 1.0. In most cases, Message Queuing generates and sets the DigitalSignature property when the sending application requests authentication. The receiving application uses this property to retrieve the digital signature attached to the message.

You can only use the DigitalSignature property when running Message Queuing version 2.0. The sending application must specify Message Queuing version 1.0 signatures when requesting authentication. If the sending application sends a Message Queuing version 2.0 signature, this property contains a buffer of four bytes, each containing zero.

The DigitalSignature property, together with the SenderCertificate property, is also used by connector applications when a message is sent. In this scenario, the connector application—rather than Message Queuing—generates the digital signature, which it bases on the certificate of the user sending the message.

The DigitalSignature property has a maximum array size of 256.

When you set the DigitalSignature property, you must also set the ConnectorType property. When a message is sent, Message Queuing ignores the DigitalSignature property if the ConnectorType property is not also set.

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

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

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

© 2015 Microsoft