SoapHeaderException Класс

Ссылка

Определение

Пространство имен:: System.Web.Services.Protocols

Сборка:: System.Web.Services.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

SOAP-представление ошибки сервера.

public ref class SoapHeaderException : System::Web::Services::Protocols::SoapException

public class SoapHeaderException : System.Web.Services.Protocols.SoapException

[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapException

type SoapHeaderException = class
    inherit SoapException

[<System.Serializable>]
type SoapHeaderException = class
    inherit SoapException

Public Class SoapHeaderException
Inherits SoapException

Наследование: Object

Exception

SystemException

SoapException
SoapHeaderException

Атрибуты: SerializableAttribute

Примеры

В следующем примере клиент веб-службы XML вызывает MyWebMethod метод веб-службы XML, передавая заголовок SOAP типа MyHeader с заданным свойством MustUnderstand true. Если метод веб-службы XML не задает DidUnderstand для свойства заголовка MyHeader trueSOAP значение, 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 должен присвоить trueDidUnderstand свойству значение; в противном случае SoapHeaderException возникает исключение.

Свойство Detail не может быть задано в соответствии со спецификацией SOAP для объекта SoapHeaderException.

Примечание

Приложения, использующие спецификацию SOAP 1.1 в качестве протокола службы, могут использовать SoapHeaderException для доступа к сбоям SOAP. Однако приложения, использующие спецификацию SOAP 1.2, должны использовать SoapException для доступа к сбоям SOAP.

Конструкторы

SoapHeaderException()	Инициализирует новый экземпляр класса SoapHeaderException.
SoapHeaderException(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр класса SoapHeaderException с параметрами для управления сериализацией.
SoapHeaderException(String, XmlQualifiedName)	Инициализирует новый экземпляр класса SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, Exception)	Инициализирует новый экземпляр класса SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, String)	Инициализирует новый экземпляр класса SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, String, Exception)	Инициализирует новый экземпляр класса SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)	Инициализирует новый экземпляр класса SoapHeaderException со связанными данными.
SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)	Инициализирует новый экземпляр класса SoapHeaderException со связанными данными.

Свойства

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-элементе `subcode` ошибки SOAP. (Унаследовано от SoapException)
TargetSite	Возвращает метод, создавший текущее исключение. (Унаследовано от Exception)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Заполняет объект SerializationInfo сведениями об исключении. (Унаследовано от SoapException)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

Является устаревшей.

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

Применяется к

Share via