EnvelopeVersion Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Contains information related to the version of SOAP associated with a message and its exchange.
public ref class EnvelopeVersion sealed
public sealed class EnvelopeVersion
type EnvelopeVersion = class
Public NotInheritable Class EnvelopeVersion
- Inheritance
-
EnvelopeVersion
Examples
The following code shows how to access the methods and properties of 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)
'
Remarks
The SOAP versions currently available are SOAP 1.1 and SOAP 1.2. There is an EnvelopeVersion for each of these versions of SOAP that can be recovered using the Soap11 and Soap12 properties. There is also a None message version that is used to sent and receive XML messages that do not use SOAP formatting. The processing roles associated with each message version can be recovered using the NextDestinationActorValue property and the GetUltimateDestinationActorValues method.
Properties
NextDestinationActorValue |
Gets a string that contains the URI name for the SOAP role associated with the current message version for the next destination. |
None |
Gets the envelope version not using a version of SOAP. |
Soap11 |
Gets the SOAP1.1 envelope version. |
Soap12 |
Gets the SOAP1.2 envelope version. |
Methods
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
GetUltimateDestinationActorValues() |
Gets a string that contains the URI name for the SOAP role associated with the current message version for the ultimate destination. |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
ToString() |
Gets a string that represents the current envelope version. |