Soap12FaultCodes Class

Reference

Definition

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Defines the SOAP fault codes that appear in a SOAP message when an error occurs while communicating with XML Web services using the SOAP version 1.2 protocol.

public ref class Soap12FaultCodes sealed

public sealed class Soap12FaultCodes

type Soap12FaultCodes = class

Public NotInheritable Class Soap12FaultCodes

Inheritance: Object
Soap12FaultCodes

Remarks

A SOAP fault in version 1.2 of the SOAP specification contains a Code element and among other things an optional Subcode element.

The Code element is one of a pre-defined set of codes that informs a recipient that the cause of the error fell into one of five large error categories. Those five fault codes are represented by the Soap12FaultCodes.ReceiverFaultCode, Soap12FaultCodes.SenderFaultCode, Soap12FaultCodes.VersionMismatchFaultCode, Soap12FaultCodes.MustUnderstandFaultCode, and Soap12FaultCodes.DataEncodingUnknownFaultCode fields.

The Subcode element allows the sender of the SOAP fault to provide an application-specific error code. ASP.NET defines four such codes that are represented by the Soap12FaultCodes.RpcProcedureNotPresentFaultCode, Soap12FaultCodes.RpcBadArgumentsFaultCode, Soap12FaultCodes.EncodingMissingIdFaultCode, and Soap12FaultCodes.EncodingUntypedValueFaultCode fields.

An XML Web service throwing an exception sets the Code property, which represents the Code element, when a new instance of the SoapException or SoapHeaderException class is created. That error is transmitted over the wire as a SOAP fault, which a .NET Framework client can catch as a SoapException or SoapHeaderException.

Fields

DataEncodingUnknownFaultCode	Represents the SOAP version 1.2 `DataEncodingUnknown` fault code indicating the SOAP message is encoded in an unrecognized format.
EncodingMissingIdFaultCode	Represents the fault code for missing ID in SOAP encoding data.
EncodingUntypedValueFaultCode	Represents the SOAP version 1.2 `enc:UntypedValue` fault subcode indicating that the SOAP message was RPC-encoded and the type name property of an encoded graph node was not specified.
MustUnderstandFaultCode	Represents the SOAP version 1.2 `MustUnderstand` fault code indicating a SOAP header marked with the `MustUnderstand` attribute was not processed.
ReceiverFaultCode	Represents the SOAP version 1.2 `Receiver` fault code indicating an error occurred during the processing of a client call on the server due to a problem with the recipient.
RpcBadArgumentsFaultCode	Represents the SOAP version 1.2 `rpc:BadArguments` fault subcode indicating that arguments sent to the XML Web service method were incorrect or could not be parsed.
RpcProcedureNotPresentFaultCode	Represents the SOAP version 1.2 `rpc:ProcedureNotPresent` fault subcode indicating the XML Web service does not support the requested XML Web service method.
SenderFaultCode	Represents the SOAP version 1.2 `Sender` fault code indicating a client call was not formatted correctly or did not contain the appropriate information.
VersionMismatchFaultCode	Represents the SOAP version 1.2 `VersionMismatch` fault code indicating the XML Web service expected SOAP messages conforming to the SOAP 1.2 specification, yet received one conforming to SOAP 1.1.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Share via