MessageVersion Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa wersje protokołu SOAP i WS-Addressing skojarzone z komunikatem i jego wymianą.
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
- Dziedziczenie
-
MessageVersion
- Atrybuty
Uwagi
MessageVersion zawiera informacje dotyczące przechowywania wersji zarówno koperty protokołu SOAP, jak i protokołu adresowania używanego przez komunikat. Wystąpienie Message jest powiązane z utworzeniem określonego MessageVersion przez przekazanie wersji jako parametru do jednego z przeciążeń CreateMessage.
Wszystkie statyczne właściwości "get" w tej klasie, takie jak Soap11WSAddressing10 i Soap12 mają semantyki podobne do wyliczenia. Zapewniają one wyliczenie możliwych wersji komunikatów obsługiwanych przez środowisko uruchomieniowe programu Windows Communication Foundation (WCF). Wiadomość ma strukturę koperty i strukturę adresowania. MessageVersion jest tylko skrótem do dostarczania {EnvelopeVersion, AddressingVersion} razem.
Obecnie dostępne są dwie wersje kopert PROTOKOŁU SOAP: SOAP 1.1 i SOAP 1.2. Te wersje protokołu SOAP są reprezentowane przez EnvelopeVersion i są zwracane przez właściwości Soap11 i Soap12. Wersję protokołu SOAP skojarzoną z MessageVersion można odzyskać przy użyciu właściwości Envelope. Aby uzyskać więcej informacji, zobacz schemat SOAP 1.1 i SOAP 1.2.
Obecnie dostępne są dwie wersje WS-Addressing. Przedłożony 10 sierpnia 2004 r. i określony w protokole WS-Addressing 1.0. Wersję adresu używaną przez bieżącą wersję komunikatu można odzyskać przy użyciu właściwości Addressing. Te wersje WS-Addressing są reprezentowane przez AddressingVersion i są zwracane przez właściwości WSAddressingAugust2004 i WSAddressing10. WS-Addressing sierpnia 2004 r. jest zachowywana jako starsza wartość. 10 sierpnia 2004 r. przesyłanie członków W3C do WS-Addressing jest dostępne na stronie Web Services Addressing (WS-Addressing). Zalecenie kandydata do W3C z dnia 17 sierpnia 2005 r. dla WS-Addressing 1.0 — Core jest dostępne na stronie Web Services Addressing 1.0 — Core.
None zapewnia obsługę obsługi komunikatów w stylu "zwykłego starego kodu XML" (POX). Włączenie podstawowej obsługi komunikatów POX jest teraz kwestią skonfigurowania powiązania HTTP w usłudze za pomocą kodera tekstowego korzystającego z None.
Obiekty wersji komunikatów można tworzyć przy użyciu określonych wersji WS-Addressing i protokołu SOAP przy użyciu jednego z przeciążeń CreateVersion.
Właściwości
Addressing |
Pobiera lub ustawia wersję WS-Addressing skojarzoną z bieżącą wersją komunikatu. |
Default |
Pobiera domyślną wersję komunikatu używaną przez program Windows Communication Foundation (WCF). |
Envelope |
Pobiera wersję protokołu SOAP skojarzoną z bieżącą wersją komunikatu. |
None |
Pobiera wersję komunikatu, która nie używa protokołu SOAP ani adresowania WS. |
Soap11 |
Pobiera wersję komunikatu przy użyciu protokołu SOAP 1.1. |
Soap11WSAddressing10 |
Pobiera wersję komunikatu przy użyciu WS-Addressing 1.0 i SOAP 1.1. |
Soap11WSAddressingAugust2004 |
Pobiera wersję komunikatu przy użyciu WS-Addressing przesłanych 10 sierpnia 2004 r. i protokołu SOAP 1.1. |
Soap12 |
Pobiera wersję komunikatu przy użyciu protokołu SOAP 1.2. |
Soap12WSAddressing10 |
Pobiera wersję komunikatu przy użyciu WS-Addressing 1.0 i PROTOKOŁU SOAP 1.2. |
Soap12WSAddressingAugust2004 |
Pobiera wersję komunikatu przy użyciu WS-Addressing przesłanych sierpnia 2004 r. i protokołu SOAP 1.2. |
Metody
CreateVersion(EnvelopeVersion, AddressingVersion) |
Tworzy obiekt wersji komunikatu z określonymi wersjami protokołu SOAP i WS-Addressing. |
CreateVersion(EnvelopeVersion) |
Tworzy obiekt wersji komunikatu przy użyciu WS-Addressing 1.0 i z określoną wersją protokołu SOAP. |
Equals(Object) |
Zwraca wartość wskazującą, czy bieżąca wersja komunikatu jest równa określonemu obiektowi. |
GetHashCode() |
Pobiera kod skrótu dla bieżącej wersji komunikatu. |
GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżącą wersję komunikatu. |