SoapHeader.MustUnderstand Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, указывающее, должен ли быть понят заголовок SoapHeader.
public:
property bool MustUnderstand { bool get(); void set(bool value); };
public bool MustUnderstand { get; set; }
member this.MustUnderstand : bool with get, set
Public Property MustUnderstand As Boolean
Значение свойства
Значение true
, если веб-служба XML должна правильно интерпретировать и обрабатывать заголовок SoapHeader; в противном случае — значение false
. Значение по умолчанию — false
.
Примеры
Следующий клиент веб-службы XML определяет пользовательский заголовок SOAP типа MyHeader
, задает MustUnderstand для свойства значение true
и вызывает MyWebMethod
метод веб-службы XML. Если метод веб-службы XML не задает DidUnderstand для свойства заголовка MyHeader
true
SOAP значение, SoapHeaderException возникает исключение.
int main()
{
MyWebService^ ws = gcnew MyWebService;
try
{
MyHeader^ customHeader = gcnew MyHeader;
customHeader->MyValue = "Header Value for MyValue";
customHeader->MustUnderstand = true;
ws->myHeader = customHeader;
int results = ws->MyWebMethod( 3, 5 );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception: {0}", e );
}
}
using System;
public class Sample {
public static void Main() {
MyWebService ws = new MyWebService();
try {
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header Value for MyValue";
customHeader.MustUnderstand = true;
ws.myHeader = customHeader;
int results = ws.MyWebMethod(3,5);
}
catch (Exception e) {
Console.WriteLine ("Exception: {0}", e.ToString());
}
}
}
Public Class Sample
Public Shared Sub Main()
Dim ws As New MyWebService()
Try
Dim customHeader As New MyHeader1()
customHeader.MyValue = "Header Value for MyValue"
customHeader.MustUnderstand = True
ws.myHeader = customHeader
Dim results As Integer
results = ws.MyWebMethod(3,5)
Catch e As Exception
Console.WriteLine("Exception: {0}", e.ToString())
End Try
End Sub
End Class
Комментарии
Когда клиент веб-службы XML добавляет заголовок SOAP в вызов метода веб-службы XML с MustUnderstand заданным true
свойством, метод веб-службы XML должен задать DidUnderstand для свойства значениеtrue
; в противном случае SoapHeaderException возвращается клиенту веб-службы XML с помощью ASP.NET.
EncodedMustUnderstand Хотя и MustUnderstand свойства можно использовать для задания значения атрибута mustUnderstand
в заголовке SOAP, MustUnderstand свойство позволяет задать атрибут с помощью логического значения.
Дополнительные сведения о добавлении заголовков SOAP в клиенты см. в статье "Использование заголовков SOAP".