EnvelopeVersion 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.
Zawiera informacje związane z wersją protokołu SOAP skojarzoną z komunikatem i jego wymianą.
public ref class EnvelopeVersion sealed
public sealed class EnvelopeVersion
type EnvelopeVersion = class
Public NotInheritable Class EnvelopeVersion
- Dziedziczenie
-
EnvelopeVersion
Przykłady
Poniższy kod pokazuje, jak uzyskać dostęp do metod i właściwości programu EnvelopeVersion.
using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Text;
namespace CS
{
class Program
{
static void Main(string[] args)
{
// MessageVersion
EnvelopeVersion envS11 = EnvelopeVersion.Soap11;
string nextDestS11 = envS11.NextDestinationActorValue;
string[] ultDestsS11 = envS11.GetUltimateDestinationActorValues();
string ultS11 = ultDestsS11[0];
string toStrS11 = envS11.ToString();
EnvelopeVersion envS12 = EnvelopeVersion.Soap12;
EnvelopeVersion envNotSOAP = EnvelopeVersion.None;
string nextDestS12 = envS12.NextDestinationActorValue;
string[] ultDestsS12 = envS12.GetUltimateDestinationActorValues();
string ultS12 = ultDestsS12[1];
string toStrS12 = envS12.ToString();
EnvelopeVersion envNone = EnvelopeVersion.None;
string nextDestNone = envNone.NextDestinationActorValue;
//The following code throws a System.ArgumentReferenceException.
//The object reference is not set to an instance of an object
// string[] ultDestsNone = envNone.GetUltimateDestinationActorValues();
string toStrNone = envNone.ToString();
//EnvelopeVersions
Console.WriteLine("EnvelopeVersion.Soap11: {0}", envS11);
Console.WriteLine("EnvelopeVersion.Soap12: {0}", envS12);
Console.WriteLine("EnvelopeVersion.None: {0}", envNone);
Console.WriteLine();
//NextDestination
Console.WriteLine("NextDest EnvelopeVersion.Soap11: {0}", nextDestS11);
Console.WriteLine("NextDest EnvelopeVersion.Soap12: {0}", nextDestS12);
Console.WriteLine("NextDest EnvelopeVersion.None: {0}", nextDestNone);
Console.WriteLine();
//UltimateDestinations
Console.WriteLine("UltDest EnvelopeVersion.Soap11: {0}", ultS11);
Console.WriteLine("UltDest EnvelopeVersion.Soap12: {0}", ultS12);
//Console.WriteLine("UltDest EnvelopeVersion.None: {0}", ultDestsNone);
Console.WriteLine();
//ToString
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrS11);
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrS12);
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrNone);
Console.WriteLine();
}
}
}
/*
Output:
EnvelopeVersion.Soap11: Soap11 (http://schemas.xmlsoap.org/soap/envelope/)
EnvelopeVersion.Soap12: Soap12 (http://www.w3.org/2003/05/soap-envelope)
EnvelopeVersion.None: EnvelopeNone (http://schemas.microsoft.com/ws/2005/05/envelope/none)
NextDest EnvelopeVersion.Soap11: http://schemas.xmlsoap.org/soap/actor/next
NextDest EnvelopeVersion.Soap12: http://www.w3.org/2003/05/soap-envelope/role/next
NextDest EnvelopeVersion.None:
UltDest EnvelopeVersion.Soap11:
UltDest EnvelopeVersion.Soap12:
EnvelopeVersion.Soap11.ToString(): Soap11 (http://schemas.xmlsoap.org/soap/envelope/)
EnvelopeVersion.Soap11.ToString(): Soap12 (http://www.w3.org/2003/05/soap-envelope)
EnvelopeVersion.Soap11.ToString(): EnvelopeNone (http://schemas.microsoft.com/ws/2005/05/envelope/none)
*/
Imports System.Collections.Generic
Imports System.ServiceModel
Imports System.Text
Namespace CS
Module Module1
Sub Main(ByVal args() As String)
' MessageVersion
Dim envS11 As EnvelopeVersion = EnvelopeVersion.Soap11
Dim nextDestS11 As String = envS11.NextDestinationActorValue
Dim ultDestsS11() As String = envS11.GetUltimateDestinationActorValues()
Dim ultS11 As String = ultDestsS11(0)
Dim toStrS11 As String = envS11.ToString()
Dim envS12 As EnvelopeVersion = EnvelopeVersion.Soap12
Dim envNotSOAP As EnvelopeVersion = EnvelopeVersion.None
Dim nextDestS12 As String = envS12.NextDestinationActorValue
Dim ultDestsS12() As String = envS12.GetUltimateDestinationActorValues()
Dim ultS12 As String = ultDestsS12(1)
Dim toStrS12 As String = envS12.ToString()
Dim envNone As EnvelopeVersion = EnvelopeVersion.None
Dim nextDestNone As String = envNone.NextDestinationActorValue
'The following code throws a System.ArgumentReferenceException.
'The object reference is not set to an instance of an object
' string[] ultDestsNone = envNone.GetUltimateDestinationActorValues();
Dim toStrNone As String = envNone.ToString()
'EnvelopeVersions
Console.WriteLine("EnvelopeVersion.Soap11: {0}", envS11)
Console.WriteLine("EnvelopeVersion.Soap12: {0}", envS12)
Console.WriteLine("EnvelopeVersion.None: {0}", envNone)
Console.WriteLine()
'NextDestination
Console.WriteLine("NextDest EnvelopeVersion.Soap11: {0}", nextDestS11)
Console.WriteLine("NextDest EnvelopeVersion.Soap12: {0}", nextDestS12)
Console.WriteLine("NextDest EnvelopeVersion.None: {0}", nextDestNone)
Console.WriteLine()
'UltimateDestinations
Console.WriteLine("UltDest EnvelopeVersion.Soap11: {0}", ultS11)
Console.WriteLine("UltDest EnvelopeVersion.Soap12: {0}", ultS12)
'Console.WriteLine("UltDest EnvelopeVersion.None: {0}", ultDestsNone);
Console.WriteLine()
'ToString
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrS11)
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrS12)
Console.WriteLine("EnvelopeVersion.Soap11.ToString(): {0}", toStrNone)
Console.WriteLine()
End Sub
End Module
End Namespace
'
' *
' *
' *
'Output:
'EnvelopeVersion.Soap11: Soap11 (http://schemas.xmlsoap.org/soap/envelope/)
'EnvelopeVersion.Soap12: Soap12 (http://www.w3.org/2003/05/soap-envelope)
'EnvelopeVersion.None: EnvelopeNone (http://schemas.microsoft.com/ws/2005/05/envelope/none)
'
'NextDest EnvelopeVersion.Soap11: http://schemas.xmlsoap.org/soap/actor/next
'NextDest EnvelopeVersion.Soap12: http://www.w3.org/2003/05/soap-envelope/role/next
'NextDest EnvelopeVersion.None:
'
'UltDest EnvelopeVersion.Soap11:
'UltDest EnvelopeVersion.Soap12:
'
'EnvelopeVersion.Soap11.ToString(): Soap11 (http://schemas.xmlsoap.org/soap/envelope/)
'EnvelopeVersion.Soap11.ToString(): Soap12 (http://www.w3.org/2003/05/soap-envelope)
'EnvelopeVersion.Soap11.ToString(): EnvelopeNone (http://schemas.microsoft.com/ws/2005/05/envelope/none)
'
Uwagi
Obecnie dostępne wersje protokołu SOAP to SOAP 1.1 i SOAP 1.2. EnvelopeVersion Dla każdej z tych wersji protokołu SOAP można odzyskać przy użyciu Soap11 właściwości iSoap12. Istnieje również wersja komunikatu None używana do wysyłania i odbierania komunikatów XML, które nie używają formatowania PROTOKOŁU SOAP. Role przetwarzania skojarzone z każdą wersją komunikatu można odzyskać przy użyciu NextDestinationActorValue właściwości i GetUltimateDestinationActorValues metody.
Właściwości
NextDestinationActorValue |
Pobiera ciąg zawierający nazwę identyfikatora URI roli protokołu SOAP skojarzoną z bieżącą wersją komunikatu dla następnego miejsca docelowego. |
None |
Pobiera wersję koperty, która nie korzysta z wersji protokołu SOAP. |
Soap11 |
Pobiera wersję koperty SOAP1.1. |
Soap12 |
Pobiera wersję koperty SOAP1.2. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
GetUltimateDestinationActorValues() |
Pobiera ciąg zawierający nazwę identyfikatora URI roli protokołu SOAP skojarzoną z bieżącą wersją komunikatu dla ostatecznego miejsca docelowego. |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Pobiera ciąg reprezentujący bieżącą wersję koperty. |