System.Web.Services.Protocols.SoapException Class

Represents the exception that is thrown when an XML Web service method is called over SOAP and an exception occurs.

See Also: SoapException Members

Syntax

public class SoapException : SystemException

Remarks

The System.Web.Services.Protocols.SoapException can either be thrown by the common language runtime or by an XML Web service method. The common language runtime can throw a System.Web.Services.Protocols.SoapException if a response to a request is not formatted correctly. XML Web service methods can generate a System.Web.Services.Protocols.SoapException by simply throwing an exception within the XML Web service method. If the client accessed the method over SOAP, the exception is caught on the server and wrapped inside a new System.Web.Services.Protocols.SoapException. The System.Web.Services.Protocols.SoapException thrown has the following property values:

Exception.Message

The Exception.Message property of the original exception.

SoapException.Code

SoapException.ServerFaultCode.

SoapException.Actor

The URL of the XML Web service method.

SoapException.Detail

null, but an empty detail element is present in the fault element.

An XML Web service method might throw a System.Web.Services.Protocols.SoapException when clients call using SOAP. If an XML Web service throws the System.Web.Services.Protocols.SoapException, other details can be added through the SoapException.Actor, SoapException.Code and SoapException.Detail properties that cannot otherwise be set by an XML Web service method if another type of exception is thrown.

Requirements

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in System.Web.Services.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0