MessageVersion Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje verze protokolu SOAP a WS-Addressing spojené se zprávou a její výměnou.
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
- Dědičnost
-
MessageVersion
- Atributy
Poznámky
Obsahuje MessageVersion informace o správě verzí jak o obálce SOAP, tak o adresovacím protokolu, který se používá ve zprávě. Instance je Message vázána na vytvoření konkrétního MessageVersion předáním verze jako parametru CreateMessage do jednoho z přetížení.
Všechny statické vlastnosti get v této třídě, například Soap11WSAddressing10 a Soap12 mají sémantiku podobné výčtu. Poskytují výčet možných verzí zpráv podporovaných modulem runtime WCF (Windows Communication Foundation). Zpráva má strukturu obálky a strukturu adresování. MessageVersion je jenom zkratka pro společné dodání {EnvelopeVersion, AddressingVersion}.
V současné době jsou k dispozici dvě verze obálky SOAP: SOAP 1.1 a SOAP 1.2. Tyto verze protokolu SOAP jsou reprezentovány EnvelopeVersion a jsou vráceny vlastnostmi Soap11 a Soap12 . Verzi protokolu SOAP přidruženou k objektu MessageVersion lze obnovit pomocí Envelope vlastnosti . Další informace najdete ve schématu pro protokoly SOAP 1.1 a SOAP 1.2.
Aktuálně jsou k dispozici dvě verze WS-Addressing. Ten odeslaný dne 10. srpna 2004 a ten uvedený v protokolu WS-Addressing 1.0. Verzi adresy používanou aktuální verzí zprávy je možné obnovit pomocí Addressing vlastnosti . Tyto verze WS-Addressing jsou reprezentovány AddressingVersion a jsou vráceny vlastnostmi WSAddressingAugust2004 a WSAddressing10 . WS-Addressing srpna 2004 se zachová jako starší hodnota. Odeslání člena W3C pro WS-Addressing z 10. srpna 2004 je k dispozici na stránce Web Services Addressing (WS-Addressing). Doporučení W3C Candidate z 17. srpna 2005 pro WS-Addressing 1.0 – Core je k dispozici na stránce Web Services Addressing 1.0 – Core.
None poskytuje podporu pro používání zasílání zpráv ve stylu "prostého starého XML" (POX). Povolení základního zasílání zpráv POX je teď otázkou nastavení vazby HTTP ve vaší službě pomocí textového kodéru, který používá None.
Objekty verze zpráv lze vytvořit pomocí zadaných verzí WS-Addressing a SOAP pomocí jednoho z CreateVersion přetížení.
Vlastnosti
Addressing |
Získá nebo nastaví verzi WS-Addressing, která je přidružena k aktuální verzi zprávy. |
Default |
Získá výchozí verzi zprávy, kterou používá Windows Communication Foundation (WCF). |
Envelope |
Získá verzi SOAP přidruženou k aktuální verzi zprávy. |
None |
Získá verzi zprávy, která nepoužívá SOAP nebo WS-Addressing. |
Soap11 |
Získá verzi zprávy pomocí protokolu SOAP 1.1. |
Soap11WSAddressing10 |
Získá verzi zprávy pomocí WS-Addressing 1.0 a SOAP 1.1. |
Soap11WSAddressingAugust2004 |
Získá verzi zprávy pomocí WS-Addressing odeslaných 10. srpna 2004 a SOAP 1.1. |
Soap12 |
Získá verzi zprávy pomocí soap 1.2. |
Soap12WSAddressing10 |
Získá verzi zprávy pomocí WS-Addressing 1.0 a SOAP 1.2. |
Soap12WSAddressingAugust2004 |
Získá verzi zprávy pomocí WS-Addressing odeslaných v srpnu 2004 a SOAP 1.2. |
Metody
CreateVersion(EnvelopeVersion) |
Vytvoří objekt verze zprávy pomocí WS-Addressing 1.0 a se zadanou verzí SOAP. |
CreateVersion(EnvelopeVersion, AddressingVersion) |
Vytvoří objekt verze zprávy se zadaným protokolem SOAP a WS-Addressing verzemi. |
Equals(Object) |
Vrátí hodnotu, která označuje, zda se aktuální verze zprávy rovná zadanému objektu. |
GetHashCode() |
Získá hash kód pro aktuální verzi zprávy. |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToString() |
Vrátí řetězcovou reprezentaci aktuální verze zprávy. |