MessageVersion Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Gibt die SOAP-Version und die Version von WS-Adressierung an, die einer Nachricht und ihrem Austausch zugeordnet sind.

public ref class MessageVersion sealed

public sealed class MessageVersion

[System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))]
public sealed class MessageVersion

type MessageVersion = class

[<System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))>]
type MessageVersion = class

Public NotInheritable Class MessageVersion

Vererbung

Object

MessageVersion

Attribute

TypeConverterAttribute

Hinweise

Die MessageVersion enthält die Versionsinformationen sowohl für den SOAP-Umschlag als auch für das Adressierungsprotokoll, das von einer Nachricht verwendet wird. Eine Instanz der Message wird beim Erstellen durch Übergeben der Version als Parameter in eine der MessageVersion-Überladungen an eine bestimmte CreateMessage gebunden.

Alle statischen "get"-Eigenschaften in dieser Klasse, z. B. Soap11WSAddressing10 und Soap12, weisen eine enumerationsartige Semantik auf. Sie stellen eine Aufzählung der möglichen Nachrichtenversionen bereit, die von der Windows Communication Foundation (WCF)-Laufzeit unterstützt werden. Eine Nachricht besteht aus einer Umschlagsstruktur und einer Adressierungsstruktur. MessageVersion ist lediglich eine Kurzform für die gemeinsame Bereitstellung von {EnvelopeVersion, AddressingVersion}.

Es sind derzeit zwei SOAP-Umschlagversionen verfügbar: SOAP 1.1 und SOAP 1.2. Diese SOAP-Versionen werden durch EnvelopeVersion dargestellt und von der Soap11-Eigenschaft und der Soap12-Eigenschaft zurückgegeben. Die Version von SOAP, die MessageVersion zugeordnet ist, 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 der WS-Adressierung verfügbar. Die Version der WS-Adressierung, die am 10. August 2004 vorgelegt wurde, und die Version der WS-Adressierung, die dem Protokoll 1.0 entspricht. Die von der aktuellen Nachrichtenversion verwendete Adressversion kann mit der Addressing-Eigenschaft abgerufen werden. Diese Versionen der WS-Adressierung werden durch AddressingVersion dargestellt und von der WSAddressingAugust2004-Eigenschaft und der WSAddressing10-Eigenschaft zurückgegeben. Die WS-Adressierung vom August 2004 wird als Legacywert beibehalten. Die 10. August 2004 W3C-Memberübermittlung für WS-Addressing ist unter Web Services-Adressierung (WS-Adressierung) verfügbar. Die Empfehlung für W3C-Kandidaten vom 17. August 2005 für WS-Addressing 1.0 – Core ist unter Web Services Addressing 1.0 - Core verfügbar.

None bietet Unterstützung für die Verwendung von "nur alten XML" (POX)-Formatnachrichten. Richten Sie eine HTTP-Bindung für Ihren Dienst mit einem Text-Encoder ein, der None verwendet, um das grundlegende POX-Messaging zu aktivieren.

Nachrichtenversionsobjekte können mit den angegebenen Versionen der WS-Adressierung und der angegebenen SOAP-Version unter Verwendung einer CreateVersion-Überladung erstellt werden.

Eigenschaften

Addressing	Ruft die Version der WS-Adressierung ab, die der aktuellen Nachrichtenversion zugeordnet ist, oder legt diese fest.
Default	Ruft die Standardnachrichtenversion ab, die von Windows Communication Foundation (WCF) verwendet wird.
Envelope	Ruft die SOAP-Version ab, die mit der aktuellen Nachrichtenversion verknüpft ist.
None	Ruft die Nachrichtenversion ab, die kein SOAP oder keine WS-Adressierung verwendet.
Soap11	Ruft die Nachrichtenversion mit SOAP 1.1 ab.
Soap11WSAddressing10	Ruft die Nachrichtenversion mit der WS-Adressierung, Version 1.0 und SOAP, Version 1.1 ab.
Soap11WSAddressingAugust2004	Ruft die Nachrichtenversion mit der WS-Adressierung, Version vom 10. August 2004, und SOAP, Version  1.1, ab.
Soap12	Ruft die Nachrichtenversion mit SOAP 1.2 ab.
Soap12WSAddressing10	Ruft die Nachrichtenversion mit der WS-Adressierung 1.0 und SOAP  1.2 ab.
Soap12WSAddressingAugust2004	Ruft die Nachrichtenversion mit der WS-Adressierung, Version vom August 2004, und SOAP, Version 1.2, ab.

Methoden

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