MessageVersion Classe

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.0.0

Origem:

MessageVersion.cs

Especifica que as versões de SOAP e WS-Addressing associados a uma mensagem e sua troca.

public ref class MessageVersion sealed

public sealed class MessageVersion

type MessageVersion = class

Public NotInheritable Class MessageVersion

Herança

Object

MessageVersion

Comentários

O MessageVersion contém as informações de controle de versão sobre o envelope SOAP e o protocolo de endereçamento usado por uma mensagem. Uma instância de Message é associada à criação a um específico MessageVersion passando a versão como um parâmetro para uma das CreateMessage sobrecargas.

Todas as propriedades estáticas "get" nessa classe, como Soap11WSAddressing10 e têm semântica semelhante à enumeração Soap12 . Eles fornecem uma enumeração das possíveis versões de mensagem compatíveis com o runtime do WCF (Windows Communication Foundation). Uma mensagem tem uma estrutura de envelope e uma estrutura de endereçamento. MessageVersion é apenas um atalho para fornecer {EnvelopeVersion, AddressingVersion} juntos.

Atualmente, há duas versões de envelope SOAP disponíveis: SOAP 1.1 e SOAP 1.2. Essas versões do SOAP são representadas por EnvelopeVersion e são retornadas pelas Soap11 propriedades e Soap12 . A versão do SOAP associada MessageVersion ao pode ser recuperada usando a Envelope propriedade . Para obter mais informações, consulte o esquema para SOAP 1.1 e SOAP 1.2.

Atualmente, há duas versões de WS-Addressing disponíveis. O enviado em 10 de agosto de 2004 e o especificado no protocolo WS-Addressing 1.0. A versão do endereço usada pela versão da mensagem atual pode ser recuperada usando a Addressing propriedade . Essas versões de WS-Addressing são representadas por AddressingVersion e são retornadas pelas WSAddressingAugust2004 propriedades e WSAddressing10 . O WS-Addressing agosto de 2004 é mantido como um valor herdado. O envio de membro W3C de 10 de agosto de 2004 para WS-Addressing está disponível em Endereçamento de Serviços Web (Endereçamento WS). A Recomendação de Candidato W3C de 17 de agosto de 2005 para WS-Addressing 1.0 – Core está disponível em Serviços Web Endereçamento 1.0 – Core.

None fornece suporte para usar mensagens no estilo "XML antigo simples" (POX). Habilitar mensagens POX básicas agora é uma questão de configurar uma associação HTTP em seu serviço com um codificador de texto que usa None.

Objetos de versão de mensagem podem ser criados usando versões especificadas de WS-Addressing e SOAP usando uma das CreateVersion sobrecargas.

Propriedades

Addressing	Obtém ou define a versão do WS-Addressing associada à versão atual da mensagem.
Default	Obtém a versão de mensagem padrão usada pelo WCF (Windows Communication Foundation).
Envelope	Obtém a versão SOAP associada à versão atual da mensagem.
None	Obtém a versão de mensagem que não usa SOAP nem endereçamento WS.
Soap11	Obtém a versão da mensagem usando o SOAP 1.1.
Soap11WSAddressing10	Obtém a versão de mensagem usando WS-Addressing 1.0 e SOAP 1.1.
Soap11WSAddressingAugust2004	Obtém a versão de mensagem usando o WS-Addressing enviado em 10 de agosto de 2004 e SOAP 1.1.
Soap12	Obtém a versão da mensagem que usa o SOAP 1.2.
Soap12WSAddressing10	Obtém a versão de mensagem usando o WS-Addressing 1.0 e SOAP 1.2.
Soap12WSAddressingAugust2004	Obtém a versão de mensagem usando o WS-Addressing enviado em agosto de 2004 e SOAP 1.2.

Métodos

CreateVersion(EnvelopeVersion)	Cria um objeto de versão de mensagem usando WS-Addressing 1.0 e com uma versão especificada do SOAP.
CreateVersion(EnvelopeVersion, AddressingVersion)	Cria um objeto de versão de mensagem com versões SOAP e WS-Addressing especificadas.
Equals(Object)	Retorna um valor que indica se a versão atual da mensagem é igual a um objeto especificado.
GetHashCode()	Obtém um código hash para a versão atual da mensagem.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna a representação de cadeia de caracteres da versão da mensagem atual.