SoapHeaderException Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представление ошибки сервера SOAP.
public ref class SoapHeaderException : System::Web::Services::Protocols::SoapExceptionpublic class SoapHeaderException : System.Web.Services.Protocols.SoapException[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapExceptiontype SoapHeaderException = class
inherit SoapException[<System.Serializable>]
type SoapHeaderException = class
inherit SoapExceptionPublic Class SoapHeaderException
Inherits SoapException- Наследование
- Атрибуты
Примеры
В следующем примере клиент веб-службы XML вызывает MyWebMethod метод веб-службы XML, передавая заголовок SOAP типа MyHeader с заданным trueсвойствомMustUnderstand. Если метод веб-службы XML не задает DidUnderstand для свойства заголовка MyHeadertrueSOAP значение, 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 возникает исключение.
Свойство Detail не может быть задано в соответствии со спецификацией SOAP для объекта SoapHeaderException.
Замечание
Приложения, использующие спецификацию SOAP 1.1 в качестве протокола службы, могут использовать SoapHeaderException доступ к сбоям SOAP. Однако приложения, использующие спецификацию SOAP 1.2, должны использовать SoapException для доступа к сбоям SOAP.
Конструкторы
Свойства
| Имя | Описание |
|---|---|
| Actor |
Возвращает фрагмент кода, вызвавшего исключение. (Унаследовано от SoapException) |
| Code |
Возвращает тип кода сбоя SOAP. (Унаследовано от SoapException) |
| Data |
Возвращает коллекцию пар "ключ-значение", которые предоставляют дополнительные пользовательские сведения об исключении. (Унаследовано от Exception) |
| Detail |
Возвращает сведения XmlNode об ошибках для конкретного приложения. (Унаследовано от SoapException) |
| HelpLink |
Возвращает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception) |
| HResult |
Возвращает или задает HRESULT, закодированное числовое значение, назначенное определенному исключению. (Унаследовано от Exception) |
| InnerException |
Возвращает экземпляр Exception, вызвавшего текущее исключение. (Унаследовано от Exception) |
| Lang |
Возвращает человеческий язык, связанный с исключением. (Унаследовано от SoapException) |
| Message |
Возвращает сообщение, описывающее текущее исключение. (Унаследовано от Exception) |
| Node |
Возвращает универсальный код ресурса (URI), представляющий фрагмент кода, вызвавшего исключение. (Унаследовано от SoapException) |
| Role |
Возвращает универсальный код ресурса (URI), представляющий функцию веб-службы XML в обработке сообщения SOAP. (Унаследовано от SoapException) |
| Source |
Возвращает или задает имя приложения или объекта, вызывающего ошибку. (Унаследовано от Exception) |
| StackTrace |
Возвращает строковое представление непосредственных кадров в стеке вызовов. (Унаследовано от Exception) |
| SubCode |
Возвращает необязательные сведения об ошибке, содержащиеся в XML-элементе |
| TargetSite |
Возвращает метод, который вызывает текущее исключение. (Унаследовано от Exception) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetBaseException() |
При переопределении в производном классе возвращает Exception, которая является основной причиной одного или нескольких последующих исключений. (Унаследовано от Exception) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
SerializationInfo Задает сведения об исключении. (Унаследовано от SoapException) |
| GetType() |
Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception) |
События
| Имя | Описание |
|---|---|
| SerializeObjectState |
Устаревшие..
Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception) |
