SoapException SoapException SoapException SoapException Class

Definition

Stellt die bei Aufruf einer XML-Webdienstmethode über SOAP und bei Auftreten einer Ausnahme ausgelöste Ausnahme dar.Represents the exception that is thrown when an XML Web service method is called over SOAP and an exception occurs.

public ref class SoapException : SystemException
[System.Serializable]
public class SoapException : SystemException
type SoapException = class
    inherit SystemException
Public Class SoapException
Inherits SystemException
Vererbung
Abgeleitet
Attribute

Beispiele

Das folgende Beispiel löst eine SoapException , in dem die XML-Webdienstmethode legt die Detail Eigenschaft.The following example throws a SoapException where the XML Web service method sets the Detail property.

Hinweise

Die SoapException entweder ausgelöst werden kann durch die common Language Runtime oder durch eine XML-Webdienstmethode.The SoapException can either be thrown by the common language runtime or by an XML Web service method. Die common Language Runtime kann Auslösen einer SoapException Wenn eine Antwort auf eine Anforderung nicht ordnungsgemäß formatiert ist.The common language runtime can throw a SoapException if a response to a request is not formatted correctly. XML-Webdienstmethoden können generieren eine SoapException durch einfach Auslösen einer Ausnahme in der XML-Webdienste-Dienstmethode.XML Web service methods can generate a SoapException by simply throwing an exception within the XML Web service method. Wenn der Client die Methode über SOAP zugegriffen, wird die Ausnahme abgefangen wird, auf dem Server und in einem neuen umschlossen SoapException.If the client accessed the method over SOAP, the exception is caught on the server and wrapped inside a new SoapException. Die SoapException ausgelöst hat die folgenden Eigenschaftenwerte fest:The SoapException thrown has the following property values:

EigenschaftProperty WertValue
Message Die Message -Eigenschaft der ursprünglichen Ausnahme.The Message property of the original exception.
Code ServerFaultCode.ServerFaultCode.
Actor Die URL des XML-Webdienstmethode.The URL of the XML Web service method.
Detail null, jedoch eine leere Detailelements in das Fault-Element vorhanden ist.null, but an empty detail element is present in the fault element.

Eine XML-Webdienstmethode löst möglicherweise eine SoapException beim Aufrufen von Clients mithilfe von SOAP.An XML Web service method might throw a SoapException when clients call using SOAP. Wenn ein XML-Webdienst löst die SoapException, weitere Details hinzugefügt werden können, über die Actor, Code und Detail Eigenschaften, die nicht durch eine XML-Webdienstmethode festgelegt werden können-Methode aus, wenn eine andere Art von Ausnahme ausgelöst wird.If an XML Web service throws the SoapException, other details can be added through the Actor, Code and Detail properties that cannot otherwise be set by an XML Web service method if another type of exception is thrown.

Konstruktoren

SoapException() SoapException() SoapException() SoapException()

Initialisiert eine neue Instanz der SoapException-Klasse.Initializes a new instance of the SoapException class.

SoapException(SerializationInfo, StreamingContext) SoapException(SerializationInfo, StreamingContext) SoapException(SerializationInfo, StreamingContext) SoapException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der SoapException-Klasse mit serialisierten Daten.Initializes a new instance of the SoapException class with serialized data.

SoapException(String, XmlQualifiedName) SoapException(String, XmlQualifiedName) SoapException(String, XmlQualifiedName) SoapException(String, XmlQualifiedName)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung und dem angegebenen Ausnahmecode.Initializes a new instance of the SoapException class with the specified exception message and exception code.

SoapException(String, XmlQualifiedName, Exception) SoapException(String, XmlQualifiedName, Exception) SoapException(String, XmlQualifiedName, Exception) SoapException(String, XmlQualifiedName, Exception)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem Ausnahmecode und einem Verweis auf die Ursache der Ausnahme.Initializes a new instance of the SoapException class with the specified exception message, exception code, and reference to the root cause of the exception.

SoapException(String, XmlQualifiedName, SoapFaultSubCode) SoapException(String, XmlQualifiedName, SoapFaultSubCode) SoapException(String, XmlQualifiedName, SoapFaultSubCode) SoapException(String, XmlQualifiedName, SoapFaultSubCode)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem angegebenen Ausnahmecode und Subcode.Initializes a new instance of the SoapException class with the specified exception message, exception code, and subcode.

SoapException(String, XmlQualifiedName, String) SoapException(String, XmlQualifiedName, String) SoapException(String, XmlQualifiedName, String) SoapException(String, XmlQualifiedName, String)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem angegebenen Ausnahmecode und dem URI, der den für die Ausnahme verantwortlichen Codeabschnitt identifiziert.Initializes a new instance of the SoapException class with the specified exception message, exception code, and URI that identifies the piece of code that caused the exception.

SoapException(String, XmlQualifiedName, String, Exception) SoapException(String, XmlQualifiedName, String, Exception) SoapException(String, XmlQualifiedName, String, Exception) SoapException(String, XmlQualifiedName, String, Exception)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem angegebenen Ausnahmecode, dem Verweis auf die Ursache der Ausnahme und dem URI, der den für die Ausnahme verantwortlichen Code identifiziert.Initializes a new instance of the SoapException class with the specified exception message, exception code, URI that identifies the code that caused the exception, and reference to the root cause of the exception.

SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem Ausnahmecode, einem URI, der den Codeabschnitt identifiziert, der die Ausnahme verursacht hat, einem URI, der die Funktion des XML-Webdiensts bei der Verarbeitung der SOAP-Nachricht darstellt, der (natürlichen) Sprache, die der Ausnahme zugeordnet ist, den anwendungsspezifischen Ausnahmeinformationen, dem Subcode für den SOAP-Fehler und einem Verweis auf die der Ausnahme zugrunde liegende Ursache.Initializes a new instance of the SoapException class with the specified exception message, exception code, URI that identifies the piece of code that caused the exception, URI that represents the XML Web service's function in processing the SOAP message, the human language associated with the exception, the application-specific exception information, the subcode for the SOAP fault and reference to the root cause of the exception.

SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception) SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem angegebenen Ausnahmecode, den anwendungsspezifischen Ausnahmeinformationen, einem Verweis auf die Ursache der Ausnahme und dem URI, der den für die Ausnahme verantwortlichen Codeabschnitt identifiziert.Initializes a new instance of the SoapException class with the specified exception message, exception code, URI that identifies the piece of code that caused the exception, application-specific exception information, and reference to the root cause of the exception.

SoapException(String, XmlQualifiedName, String, XmlNode) SoapException(String, XmlQualifiedName, String, XmlNode) SoapException(String, XmlQualifiedName, String, XmlNode) SoapException(String, XmlQualifiedName, String, XmlNode)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem Ausnahmecode, den anwendungsspezifischen Ausnahmeinformationen und dem URI, der den für die Ausnahme verantwortlichen Codeabschnitt identifiziert.Initializes a new instance of the SoapException class with the specified exception message, exception code, URI that identifies the piece of code that caused the exception, and application specific exception information.

SoapException(String, XmlQualifiedName, String, XmlNode, Exception) SoapException(String, XmlQualifiedName, String, XmlNode, Exception) SoapException(String, XmlQualifiedName, String, XmlNode, Exception) SoapException(String, XmlQualifiedName, String, XmlNode, Exception)

Initialisiert eine neue Instanz der SoapException-Klasse mit der angegebenen Ausnahmemeldung, dem angegebenen Ausnahmecode, den anwendungsspezifischen Ausnahmeinformationen, einem Verweis auf die Ursache der Ausnahme und dem URI, der den für die Ausnahme verantwortlichen Codeabschnitt identifiziert.Initializes a new instance of the SoapException class with the specified exception message, exception code, URI that identifies the piece of code that caused the exception, application-specific exception information, and reference to the root cause of the exception.

Felder

ClientFaultCode ClientFaultCode ClientFaultCode ClientFaultCode

Gibt einen SOAP-Fehlercode an, der einen Clientaufruf darstellt, der nicht korrekt formatiert ist oder nicht die geeigneten Informationen enthält.Specifies a SOAP fault code that represents a client call that is not formatted correctly or does not contain the appropriate information.

DetailElementName DetailElementName DetailElementName DetailElementName

Ruft einen XmlQualifiedName ab, der das Detail-Element eines SOAP-Fehlercodes darstellt.Gets an XmlQualifiedName that represents the Detail element of a SOAP Fault code.

MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode

Ein SOAP-Fehlercode, der ein mit dem MustUnderstand-Attribut markiertes SOAP-Element darstellt, wurde nicht verarbeitet.A SOAP Fault Code that represents a SOAP element marked with the MustUnderstand attribute was not processed.

ServerFaultCode ServerFaultCode ServerFaultCode ServerFaultCode

Gibt einen SOAP-Fehlercode an, der einen Fehler darstellt, der beim Verarbeiten eines Clientaufrufs auf dem Server auftrat und bei dem das Problem nicht auf den Meldungsinhalt zurückzuführen ist.Specifies that a SOAP fault code that represents an error occurred during the processing of a client call on the server, where the problem is not due to the message contents.

VersionMismatchFaultCode VersionMismatchFaultCode VersionMismatchFaultCode VersionMismatchFaultCode

Während der Verarbeitung der SOAP-Nachricht wurde ein SOAP-Fehlercode gefunden, der einen ungültigen Namespace für einen SOAP-Envelope darstellt.A SOAP fault code that represents an invalid namespace for a SOAP envelope was found during the processing of the SOAP message.

Eigenschaften

Actor Actor Actor Actor

Ruft den Codeabschnitt ab, der die Ausnahme verursacht hat.Gets the piece of code that caused the exception.

Code Code Code Code

Ruft den Typ des SOAP-Fehlercodes ab.Gets the type of SOAP fault code.

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
Detail Detail Detail Detail

Ruft einen XmlNode ab, der die Einzelheiten von anwendungsspezifischen Fehlerinformationen darstellt.Gets an XmlNode that represents the application-specific error information details.

HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Lang Lang Lang Lang

Ruft die der Ausnahme zugeordnete menschliche Sprache ab.Gets the human language associated with the exception.

Message Message Message Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(Inherited from Exception)
Node Node Node Node

Ruft einen URI ab, der den für die Ausnahme verantwortlichen Codeabschnitt angibt.Gets a URI that represents the piece of code that caused the exception.

Role Role Role Role

Ruft einen URI ab, der die Funktion des XML-Webdiensts bei der Verarbeitung der SOAP-Nachricht darstellt.Gets a URI that represents the XML Web service's function in processing the SOAP message.

Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
SubCode SubCode SubCode SubCode

Ruft die im subcode-XML-Element eines SOAP-Fehlers enthaltenen optionalen Fehlerinformationen ab.Gets the optional error information contained in the subcode XML element of a SOAP fault.

TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Legt SerializationInfo mit Informationen zur Ausnahme fest.Sets the SerializationInfo with information about the exception.

GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
IsClientFaultCode(XmlQualifiedName) IsClientFaultCode(XmlQualifiedName) IsClientFaultCode(XmlQualifiedName) IsClientFaultCode(XmlQualifiedName)

Gibt einen Wert zurück, der angibt, ob der SOAP-Fehlercode unabhängig von der Version des verwendeten SOAP-Protokolls dem Client-SOAP-Fehlercode entspricht.Returns a value that indicates whether the SOAP fault code is equivalent to the Client SOAP fault code regardless of the version of the SOAP protocol used.

IsMustUnderstandFaultCode(XmlQualifiedName) IsMustUnderstandFaultCode(XmlQualifiedName) IsMustUnderstandFaultCode(XmlQualifiedName) IsMustUnderstandFaultCode(XmlQualifiedName)

Gibt einen Wert zurück, der angibt, ob der SOAP-Fehlercode unabhängig von der Version des verwendeten SOAP-Protokolls gleich MustUnderstand ist.Returns a value that indicates whether the SOAP fault code is equivalent to MustUnderstand regardless of the version of the SOAP protocol used.

IsServerFaultCode(XmlQualifiedName) IsServerFaultCode(XmlQualifiedName) IsServerFaultCode(XmlQualifiedName) IsServerFaultCode(XmlQualifiedName)

Gibt einen Wert zurück, der angibt, ob der SOAP-Fehlercode unabhängig von der Version des verwendeten SOAP-Protokolls dem Server-SOAP-Fehlercode entspricht.Returns a value that indicates whether the SOAP fault code is equivalent to the Server SOAP fault code regardless of the version of the SOAP protocol used.

IsVersionMismatchFaultCode(XmlQualifiedName) IsVersionMismatchFaultCode(XmlQualifiedName) IsVersionMismatchFaultCode(XmlQualifiedName) IsVersionMismatchFaultCode(XmlQualifiedName)

Gibt einen Wert zurück, der angibt, ob der SOAP-Fehlercode unabhängig von der Version des verwendeten SOAP-Protokolls dem VersionMismatch-SOAP-Fehlercode entspricht.Returns a value that indicates whether the SOAP fault code is equivalent to the VersionMismatch SOAP fault code regardless of the version of the SOAP protocol used.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für: