MessageVersion Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Versionen von SOAP und WS-Addressing an, die einer Nachricht und dem zugehörigen Austausch zugeordnet sind.
public ref class MessageVersion sealedpublic sealed class MessageVersion[System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))]
public sealed class MessageVersiontype MessageVersion = class[<System.ComponentModel.TypeConverter(typeof(System.ServiceModel.Configuration.MessageVersionConverter))>]
type MessageVersion = classPublic NotInheritable Class MessageVersion- Vererbung
-
MessageVersion
- Attribute
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. |
