MessageVersion Класс

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Сборка:

System.ServiceModel.dll

Указывает версии SOAP и WS-Addressing, связанные с сообщением и его передачей.

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

Наследование

Object

MessageVersion

Атрибуты

TypeConverterAttribute

Комментарии

Объект 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 года поддерживается, но считается устаревшей. Отправка члена W3C от 10 августа 2004 года для WS-Addressing доступна в веб-службах адресации (WS-Addressing). Рекомендация кандидата W3C от 17 августа 2005 г. для WS-Addressing 1.0 — Core доступна в веб-службах, адресующей 1.0 — Core.

None обеспечивает поддержку использования обмена сообщениями в стиле POX (обычный старый XML). Теперь для обеспечения поддержки обмена сообщениями в формате 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()	Возвращает строковое представление текущей версии сообщения.