Edit

Share via


Soap12FaultCodes Class

Definition

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
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