MessageVersion Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica as versões de SOAP e WS-Addressing associadas a uma mensagem e à sua troca.
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
- Herança
-
MessageVersion
- Atributos
Observações
Contém MessageVersion a informação de versionamento tanto sobre o envelope SOAP como sobre o protocolo de endereçamento utilizado por uma mensagem. Uma instância de Message é vinculada à criação a um específico MessageVersion , passando a versão como parâmetro para um dos CreateMessage overloads.
Todas as propriedades estáticas "get" desta classe, como Soap11WSAddressing10 e Soap12 possuem semântica semelhante à enumeração. Fornecem uma enumeração das possíveis versões de mensagens suportadas pelo runtime do Windows Communication Foundation (WCF). Uma mensagem tem uma estrutura de envelope e uma estrutura de endereçamento. MessageVersion é apenas um atalho para fornecer {EnvelopeVersion, AddressingVersion} em conjunto.
Atualmente, existem duas versões do envelope SOAP disponíveis: SOAP 1.1 e SOAP 1.2. Estas versões do SOAP são representadas por EnvelopeVersion e são devolvidas pelas Soap11 propriedades e.Soap12 A versão do SOAP associada ao MessageVersion pode ser recuperada utilizando a Envelope propriedade. Para mais informações, consulte o esquema do SOAP 1.1 e SOAP 1.2.
Atualmente, existem duas versões de WS-Addressing disponíveis. O que foi submetido a 10 de agosto de 2004 e o especificado no protocolo WS-Addressing 1.0. A versão do endereço usada pela versão atual da mensagem pode ser recuperada usando a Addressing propriedade. Estas versões de WS-Addressing são representadas por AddressingVersion e são devolvidas pelas WSAddressingAugust2004 propriedades e.WSAddressing10 A WS-Addressing de agosto de 2004 mantém-se como valor legado. A Submissão dos Membros do W3C de 10 de agosto de 2004 para WS-Addressing está disponível em Web Services Addressing (WS-Addressing). A Recomendação de Candidato ao W3C de 17 de agosto de 2005 para WS-Addressing 1.0 - Core está disponível em Web Services Addressing 1.0 - Core.
None oferece suporte para a utilização de mensagens do tipo "simples e antigo XML" (POX). Ativar mensagens POX básicas passa agora a ser uma questão de configurar uma ligação HTTP no seu serviço com um codificador de texto que utiliza None.
Os objetos de versão da mensagem podem ser criados usando versões especificadas de WS-Addressing e SOAP usando uma das CreateVersion sobrecargas.
Propriedades
| Name | Description |
|---|---|
| Addressing |
Obtém ou define a versão de WS-Addressing associada à versão atual da mensagem. |
| Default |
Recebe a versão padrão da mensagem usada pelo Windows Communication Foundation (WCF). |
| Envelope |
Recebe a versão SOAP associada à versão atual da mensagem. |
| None |
Recebe a versão da mensagem que não usa SOAP ou WS-Addressing. |
| Soap11 |
Obtém a versão da mensagem usando SOAP 1.1. |
| Soap11WSAddressing10 |
Obtém a versão da mensagem usando WS-Addressing 1.0 e SOAP 1.1. |
| Soap11WSAddressingAugust2004 |
Obtém a versão por mensagem usando WS-Addressing submetido a 10 de agosto de 2004 e SOAP 1.1. |
| Soap12 |
Recebe a versão da mensagem usando SOAP 1.2. |
| Soap12WSAddressing10 |
Obtém a versão da mensagem usando WS-Addressing 1.0 e SOAP 1.2. |
| Soap12WSAddressingAugust2004 |
Recebe a versão da mensagem usando WS-Addressing submetido em agosto de 2004 e SOAP 1.2. |
Métodos
| Name | Description |
|---|---|
| CreateVersion(EnvelopeVersion, AddressingVersion) |
Cria um objeto de versão de mensagem com versões SOAP e WS-Addressing especificadas. |
| CreateVersion(EnvelopeVersion) |
Cria um objeto de versão de mensagem usando WS-Addressing 1.0 e com uma versão SOAP especificada. |
| Equals(Object) |
Devolve um valor que indica se a versão atual da mensagem é igual a um objeto especificado. |
| GetHashCode() |
Recebe 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 atual Object. (Herdado de Object) |
| ToString() |
Devolve a representação da cadeia da versão atual da mensagem. |