Freigeben über


MessageVersion Klasse

Definition

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
MessageVersion
Attribute

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 Enumeration der möglichen Nachrichtenversionen bereit, die von der Windows Communication Foundation (WCF)-Runtime 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 W3C-Mitgliedsübermittlung vom 10. August 2004 für WS-Addressing ist unter Web Services Addressing (WS-Addressing) verfügbar. Die W3C Candidate Recommendation 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 Messaging im POX-Stil (Plain Old XML). 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.

Gilt für: