SoapException SoapException SoapException SoapException Class

Definition

Stellt die Ausnahme, die ausgelöst wird, wenn eine XML-Webdienstmethode über SOAP aufgerufen wird und eine Ausnahme auftritt.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 dem SoapException -Klasse mit der angegebenen Ausnahmemeldung und 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 dem SoapException Klasse mit der angegebenen Ausnahmemeldung, Ausnahmecode und 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 Angabe der Ausnahmemeldung, des Ausnahmecodes und des Subcodes.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 dem SoapException Klasse mit der angegebenen Ausnahmemeldung, Ausnahmecode und URI, der den Codeabschnitt identifiziert, die die Ausnahme verursacht hat.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 dem SoapException Klasse mit der angegebenen Ausnahmemeldung, Ausnahmecode, URI, der den Code identifiziert, die die Ausnahme verursacht und Verweis auf die Ursache der Ausnahme.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 Ausnahmenachricht, dem Ausnahmecode, dem URI, der den Codeabschnitt identifiziert, der die Ausnahme verursacht hat, mit anwendungsspezifischen Ausnahmeinformationen und einem Verweis auf die Grundursache der Ausnahme.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 dem SoapException Klasse mit der angegebenen Ausnahme Nachrichten, Ausnahmecode, URI, der den Codeabschnitt identifiziert, die die Ausnahme und anwendungsspezifischen Ausnahmeinformationen verursacht hat.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 Ausnahmenachricht, dem Ausnahmecode, dem URI, der den Codeabschnitt identifiziert, der die Ausnahme verursacht hat, mit anwendungsspezifischen Ausnahmeinformationen und einem Verweis auf die Grundursache der Ausnahme.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, der einen Clientaufruf darstellt, der ist nicht ordnungsgemäß formatiert oder enthält nicht die entsprechende Informationen an.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 eine XmlQualifiedName darstellt, die die Detail Element der SOAP-Fehlercodes.Gets an XmlQualifiedName that represents the Detail element of a SOAP Fault code.

MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode

Eine SOAP-Fehlercode, der ein SOAP-Element darstellt, die mit markiert die MustUnderstand Attribut 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 an, dass ein SOAP-Fehlercode, der einen Fehler darstellt. bei der Verarbeitung eines Clientaufrufs auf dem Server aufgetreten ist, in 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

Ein SOAP-Fehlercode, der einen ungültigen Namespace für einen SOAP-Umschlag darstellt, wurde während der Verarbeitung der SOAP-Nachricht gefunden.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, der die Ausnahme verursacht hat.Gets the piece of code that caused the exception.

Code Code Code Code

Ruft den Typ der SOAP-Fehlercode 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 eine XmlNode , die Einzelheiten der 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, der den Codeabschnitt darstellt, die die Ausnahme verursacht hat.Gets a URI that represents the piece of code that caused the exception.

Role Role Role Role

Ruft einen URI, der den XML-Webdienst-Funktion, 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 optionalen Fehlerinformationen ab, die im XML-Element vom Typ subcode eines SOAP-Fehlers enthalten sind.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, der angibt, ob der SOAP-Fehlercode, für entspricht die Client SOAP-Fehlercode unabhängig von der Version des SOAP-Protokolls verwendet.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, der angibt, ob der SOAP-Fehlercode entspricht MustUnderstand unabhängig von der Version des SOAP-Protokolls verwendet.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, der angibt, ob der SOAP-Fehlercode, für entspricht die Server SOAP-Fehlercode unabhängig von der Version des SOAP-Protokolls verwendet.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, der angibt, ob der SOAP-Fehlercode, für entspricht die VersionMismatch SOAP-Fehlercode unabhängig von der Version des SOAP-Protokolls verwendet.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: