Freigeben über


Message.DigitalSignature-Eigenschaft

Ruft die digitale Signatur ab, mit der Message Queuing die Meldung authentifiziert, oder legt diese fest.

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

Syntax

'Declaration
Public Property DigitalSignature As Byte()
'Usage
Dim instance As Message
Dim value As Byte()

value = instance.DigitalSignature

instance.DigitalSignature = value
public byte[] DigitalSignature { get; set; }
public:
property array<unsigned char>^ DigitalSignature {
    array<unsigned char>^ get ();
    void set (array<unsigned char>^ value);
}
/** @property */
public byte[] get_DigitalSignature ()

/** @property */
public void set_DigitalSignature (byte[] value)
public function get DigitalSignature () : byte[]

public function set DigitalSignature (value : byte[])

Eigenschaftenwert

Ein Bytearray, das die zur Authentifizierung der Meldung verwendete digitale Signatur von Message Queuing 1.0 enthält. Der Standardwert ist ein Array der Länge 0.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Die DigitalSignature-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

Die DigitalSignature-Eigenschaft ist NULL (Nothing in Visual Basic).

Hinweise

Message Queuing verwendet die digitale Signatur bei der Authentifizierung von Meldungen, die mit Message Queuing, Version 1.0, gesendet wurden. In den meisten Fällen generiert Message Queuing die DigitalSignature-Eigenschaft und legt diese fest, wenn die sendende Anwendung eine Authentifizierung anfordert. Die empfangende Anwendung verwendet die Eigenschaft zum Abrufen der an die Meldung angehängten digitalen Signatur.

Die DigitalSignature-Eigenschaft kann nur unter Message Queuing, Version 2.0, verwendet werden. Die sendende Anwendung muss Signaturen für Message Queuing, Version 1.0, angeben, wenn sie eine Authentifizierung anfordert. Wenn die sendende Anwendung eine Signatur für Message Queuing, Version 2.0, sendet, enthält diese Eigenschaft einen Puffer von vier Bytes mit dem Wert 0.

Darüber hinaus wird die DigitalSignature-Eigenschaft zusammen mit der SenderCertificate-Eigenschaft von Connectoranwendungen beim Senden von Meldungen verwendet. In diesem Fall generiert die Connectoranwendung, nicht Message Queuing, die digitale Signatur, die auf dem Zertifikat des Benutzers beruht, der die Meldung sendet.

Die maximale Größe des Arrays für die DigitalSignature-Eigenschaft ist 256.

Wenn Sie die DigitalSignature-Eigenschaft festlegen, müssen Sie ebenfalls die ConnectorType-Eigenschaft festlegen. Beim Senden einer Meldung ignoriert Message Queuing die DigitalSignature-Eigenschaft, wenn die ConnectorType-Eigenschaft nicht festgelegt wurde.

.NET Framework-Sicherheit

  • Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Message-Klasse
Message-Member
System.Messaging-Namespace
Message.ConnectorType-Eigenschaft
SenderCertificate
HashAlgorithm
UseAuthentication