MessageVersion Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает версии SOAP и WS-Addressing, связанные с сообщением и его передачей.
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- Наследование
-
MessageVersion
- Атрибуты
Комментарии
Объект MessageVersion содержит информацию о версиях конверта SOAP и протокола адресации, используемого в сообщении. Экземпляр класса Message при создании привязывается к определенному объекту MessageVersion путем передачи версии одному из перегруженных методов CreateMessage в качестве параметра.
Семантика всех статических свойств "get" этого класса, таких как Soap11WSAddressing10 и Soap12, подобна семантике перечислений. Они предоставляют перечисление возможных версий сообщений, поддерживаемых средой выполнения Windows Communication Foundation (WCF). У сообщения имеется структура конверта и структура адресации. MessageVersion — это краткий способ ввести совокупность {EnvelopeVersion, AddressingVersion}.
На данный момент существуют две версии конверта SOAP: SOAP 1.1 и SOAP 1.2. Эти версии SOAP представлены объектом EnvelopeVersion, их возвращают свойства Soap11 и Soap12. Версию SOAP, связанную с объектом MessageVersion, можно восстановить с помощью свойства Envelope. Дополнительные сведения см. в схеме для SOAP 1.1 и SOAP 1.2.
На данный момент существуют две версии протокола адресации WS-Addressing. Одна из них представлена 10 августа 2004 года, а другая указана в протоколе WS-Addressing 1.0. Версию адресации, используемую в текущей версии сообщения, можно получить с помощью свойства Addressing. Эти версии адресации WS-Addressing представлены объектом AddressingVersion, и их возвращают свойства WSAddressingAugust2004 и WSAddressing10. Адресация WS-Addressing от августа 2004 года поддерживается, но считается устаревшей. 10 августа 2004 года W3C Member Submission for WS-Addressing доступен на веб-службы адресации (WS-Addressing). Рекомендация W3C от 17 августа 2005 года для кандидатов для WS-Addressing 1.0 — Core доступна в веб-службах, адресуемых 1.0 — core.
None обеспечивает поддержку обмена сообщениями в стиле POX. Теперь для обеспечения поддержки обмена сообщениями в формате POX достаточно настроить для службы привязку HTTP с кодировщиком текста с использованием свойства None.
Объекты версий сообщений можно создавать с помощью указанных версий протоколов WS-Addressing и SOAP, используя один из перегруженных методов CreateVersion.
Свойства
| Addressing |
Возвращает или задает версию адресации WS-Addressing, связанной с текущей версией сообщения. |
| Default |
Возвращает версию сообщения по умолчанию, используемую службой Windows Communication Foundation (WCF). |
| Envelope |
Возвращает версию SOAP, связанную с текущей версией сообщения. |
| None |
Возвращает версию сообщения, не использующую протоколы SOAP и WS-Addressing. |
| Soap11 |
Возвращает версию сообщения, использующую протокол SOAP 1.1. |
| Soap11WSAddressing10 |
Возвращает версию сообщения, использующую протоколы WS-Addressing 1.0 и SOAP 1,1. |
| Soap11WSAddressingAugust2004 |
Возвращает версию сообщения, используя протоколы WS-Addressing от 10 августа 2004 г. и SOAP 1.1. |
| Soap12 |
Возвращает версию сообщения, использующую протокол SOAP 1.2. |
| Soap12WSAddressing10 |
Возвращает версию сообщения, использующую протоколы WS-Addressing 1.0 и SOAP 1.2. |
| Soap12WSAddressingAugust2004 |
Возвращает версию сообщения, использующую адресацию WS-Addressing, предоставленную в августе 2004 г., и протокол SOAP 1.2. |
Методы
| CreateVersion(EnvelopeVersion) |
Создает объект версии сообщения, используя протокол WS-Addressing версии 1.0 и протокол SOAP указанной версии. |
| CreateVersion(EnvelopeVersion, AddressingVersion) |
Создает объект версии сообщения с указанными версиями SOAP и WS-Addressing. |
| Equals(Object) |
Возвращает значение, указывающее, равен ли текущий объект версии сообщения указанному объекту. |
| GetHashCode() |
Возвращает хэш-код для текущей версии сообщения. |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| ToString() |
Возвращает строковое представление текущей версии сообщения. |
