MessageVersion Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

MessageVersion.cs

Gibt die Versionen von SOAP und WS-Addressing an, die einer Nachricht und dem zugehörigen Austausch zugeordnet sind.

public ref class MessageVersion sealed

public sealed class MessageVersion

type MessageVersion = class

Public NotInheritable Class MessageVersion

Vererbung

Object

MessageVersion

Hinweise

Die MessageVersion enthält die Versionsverwaltungsinformationen sowohl über den SOAP-Umschlag als auch das Adressprotokoll, das von einer Nachricht verwendet wird. Eine Instanz von Message ist an die Erstellung an eine bestimmte MessageVersion gebunden, indem die Version als Parameter an eine der CreateMessage-Überladungen übergeben wird.

Alle statischen "get"-Eigenschaften in dieser Klasse, z. B. Soap11WSAddressing10 und Soap12 verfügen über enumerationsähnliche Semantik. Sie stellen eine Aufzählung der möglichen Nachrichtenversionen bereit, die von der Windows Communication Foundation (WCF)-Laufzeit unterstützt werden. Eine Nachricht verfügt über eine Umschlagstruktur und eine Adressstruktur. MessageVersion ist nur eine Verknüpfung für die Bereitstellung von {EnvelopeVersion, AddressingVersion} zusammen.

Derzeit sind zwei SOAP-Umschlagversionen verfügbar: SOAP 1.1 und SOAP 1.2. Diese SOAP-Versionen werden durch EnvelopeVersion dargestellt und von den eigenschaften Soap11 und Soap12 zurückgegeben. Die mit der MessageVersion verknüpfte SOAP-Version kann mithilfe der Envelope-Eigenschaft wiederhergestellt werden. Weitere Informationen finden Sie im Schema für SOAP 1.1- und SOAP 1.2-.

Derzeit sind zwei Versionen von WS-Addressing verfügbar. Die am 10. August 2004 eingereichte und die im Protokoll WS-Addressing 1.0 angegebene. Die von der aktuellen Nachrichtenversion verwendete Adressversion kann mithilfe der Addressing-Eigenschaft wiederhergestellt werden. Diese Versionen von WS-Addressing werden durch AddressingVersion dargestellt und von den eigenschaften WSAddressingAugust2004 und WSAddressing10 zurückgegeben. Die WS-Addressing August 2004 wird als Legacywert beibehalten. Die W3C-Mitgliedsübermittlung für WS-Addressing vom 10. August 2004 steht unter Webdienstadressierung (WS-Addressing)zur Verfügung. Die W3C-Kandidatenempfehlung für WS-Addressing 1.0 - Core steht am 17. August 2005 unter Webdienste adressiert 1.0 - Corezur Verfügung.

None bietet Unterstützung für die Verwendung von "plain old XML" (POX)-Nachrichten. Das Aktivieren grundlegender POX-Nachrichten ist jetzt eine Frage der Einrichtung einer HTTP-Bindung für Ihren Dienst mit einem Text-Encoder, der Noneverwendet.

Nachrichtenversionsobjekte können mit angegebenen Versionen von WS-Addressing und SOAP mithilfe einer der CreateVersion-Überladungen erstellt werden.

Eigenschaften

Addressing	Dient zum Abrufen oder Festlegen der Version von WS-Addressing, die der aktuellen Nachrichtenversion zugeordnet ist.
Default	Ruft die Standardnachrichtenversion ab, die von Windows Communication Foundation (WCF) verwendet wird.
Envelope	Ruft die SOAP-Version ab, die der aktuellen Nachrichtenversion zugeordnet ist.
None	Ruft die Nachrichtenversion ab, die keine SOAP- oder WS-Adressierung verwendet.
Soap11	Ruft die Nachrichtenversion mit SOAP 1.1 ab.
Soap11WSAddressing10	Ruft die Nachrichtenversion mit WS-Addressing 1.0 und SOAP 1.1 ab.
Soap11WSAddressingAugust2004	Ruft die Nachrichtenversion mithilfe von WS-Addressing gesendet am 10. August 2004 und SOAP 1.1 ab.
Soap12	Ruft die Nachrichtenversion mit SOAP 1.2 ab.
Soap12WSAddressing10	Ruft die Nachrichtenversion mit WS-Addressing 1.0 und SOAP 1.2 ab.
Soap12WSAddressingAugust2004	Ruft die Nachrichtenversion mit WS-Addressing übermittelt august 2004 und SOAP 1.2 ab.

Methoden

CreateVersion(EnvelopeVersion, AddressingVersion)	Erstellt ein Nachrichtenversionsobjekt mit angegebenen SOAP- und WS-Addressing Versionen.
CreateVersion(EnvelopeVersion)	Erstellt ein Nachrichtenversionsobjekt mithilfe von WS-Addressing 1.0 und mit einer angegebenen SOAP-Version.
Equals(Object)	Gibt einen Wert zurück, der angibt, ob die aktuelle Nachrichtenversion einem angegebenen Objekt entspricht.
GetHashCode()	Ruft einen Hashcode für die aktuelle Nachrichtenversion ab.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt die Zeichenfolgendarstellung der aktuellen Nachrichtenversion zurück.