EnvelopeVersion Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит сведения, относящиеся к версии протокола SOAP, связанной с сообщением и его передачей.
public ref class EnvelopeVersion sealed
public sealed class EnvelopeVersion
type EnvelopeVersion = class
Public NotInheritable Class EnvelopeVersion
- Наследование
-
EnvelopeVersion
Примеры
В следующем коде показано, как получить доступ к методам и свойствам объекта 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)
'
Комментарии
В настоящее время доступны версии протокола SOAP 1.1 и SOAP 1.2. Для каждой из этих версий SOAP существует версия конверта (EnvelopeVersion), которую можно получить с помощью свойств Soap11 и Soap12. Также существует версия сообщений None, используемая для отправки и приема сообщений XML, в которых не используется форматирование SOAP. Роли обработки, связанные с каждой версией сообщений, можно получить с помощью свойства NextDestinationActorValue и метода GetUltimateDestinationActorValues.
Свойства
NextDestinationActorValue |
Возвращает строку, содержащую имя URI для роли SOAP, связанной с текущей версией сообщения, для следующей точки назначения. |
None |
Возвращает версию конверта, если не используется ни одна из версий SOAP. |
Soap11 |
Возвращает версию конверта SOAP1.1. |
Soap12 |
Возвращает версию конверта SOAP1.2. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
GetUltimateDestinationActorValues() |
Возвращает строку, содержащую имя URI для роли SOAP, связанной с текущей версией сообщения, для конечной точки назначения. |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущую версию конверта. |