SoapException Klasse

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

Im folgenden Beispiel wird eine SoapException ausgelöst, wobei die- Detail Eigenschaft von der XML-Webdienst Methode festgelegt wird.The following example throws a SoapException where the XML Web service method sets the Detail property.

<%@ WebService Language="C#" class="ThrowSoapException"%>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml.Serialization;
using System.Xml;

public class ThrowSoapException : WebService 
{
//    This XML Web service method generates a SOAP Client Fault code 
    [WebMethod]
    public void myThrow(){

        // Build the detail element of the SOAP fault.
        System.Xml.XmlDocument doc = new System.Xml.XmlDocument();
        System.Xml.XmlNode node = doc.CreateNode(XmlNodeType.Element, SoapException.DetailElementName.Name, SoapException.DetailElementName.Namespace);


        // Build specific details for the SoapException.
        // Add first child of detail XML element.
        System.Xml.XmlNode details = doc.CreateNode(XmlNodeType.Element, "mySpecialInfo1", "http://tempuri.org/");
        System.Xml.XmlNode detailsChild = doc.CreateNode(XmlNodeType.Element, "childOfSpecialInfo", "http://tempuri.org/");
        details.AppendChild(detailsChild);

            
        // Add second child of detail XML element with an attribute.
        System.Xml.XmlNode details2 = doc.CreateNode(XmlNodeType.Element, "mySpecialInfo2", "http://tempuri.org/");
        XmlAttribute attr = doc.CreateAttribute("t", "attrName", "http://tempuri.org/");
        attr.Value = "attrValue";
        details2.Attributes.Append(attr);

        // Append the two child elements to the detail node.
        node.AppendChild(details);
        node.AppendChild(details2);

            
        //Throw the exception.    
        SoapException se = new SoapException("Fault occurred", SoapException.ClientFaultCode,Context.Request.Url.AbsoluteUri,node);

        throw se;
        return;    }
}
<%@ WebService Language="VB" class="ThrowSoapException"%>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization
Imports System.Xml

Public Class ThrowSoapException
    Inherits WebService
    
    ' This XML Web service method generates a SOAP Client Fault code 
    <WebMethod()> _
    Public Sub myThrow()
        
        ' Build the detail element of the SOAP fault.
        Dim doc As New System.Xml.XmlDocument()
        Dim node As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            SoapException.DetailElementName.Name, _
            SoapException.DetailElementName.Namespace)
 
        ' Build specific details for the SoapException.
        ' Add first child of detail XML element.
        Dim details As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo1", "http://tempuri.org/")

        ' Add second child of detail XML element with an attribute.
        Dim details2 As System.Xml.XmlNode = doc.CreateNode(XmlNodeType.Element, _
            "mySpecialInfo2", "http://tempuri.org/")
        Dim attr As XmlAttribute = doc.CreateAttribute("t", "attrName", _
            "http://tempuri.org/")
        attr.Value = "attrValue"
        details2.Attributes.Append(attr)

        ' Append the two child elements to the detail node.
        node.AppendChild(details)
        node.AppendChild(details2)
                
        'Throw the exception    
        Dim se As New SoapException("Fault occurred", SoapException.ClientFaultCode, _
                                    Context.Request.Url.AbsoluteUri, node)
        Throw se
        Return
    End Sub
End Class

Hinweise

SoapException Kann entweder vom Common Language Runtime oder von einer XML-Webdienst Methode ausgelöst werden.The SoapException can either be thrown by the common language runtime or by an XML Web service method. Der Common Language Runtime kann eine SoapException auslösen, 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-Webdienst Methoden können einen SoapException generieren, indem Sie einfach eine Ausnahme innerhalb der XML-Webdienst Methode auslösen.XML Web service methods can generate a SoapException by simply throwing an exception within the XML Web service method. Wenn der Client auf die-Methode über SOAP zugegriffen hat, wird die Ausnahme auf dem Server abgefangen und in SoapExceptioneinen neuen umschließt.If the client accessed the method over SOAP, the exception is caught on the server and wrapped inside a new SoapException. Die SoapException ausgelöste weist die folgenden Eigenschaftswerte auf: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 der XML-Webdienst Methode.The URL of the XML Web service method.
Detail null, aber im Fault-Element ist ein leeres Detail Element vorhanden.null, but an empty detail element is present in the fault element.

Eine XML-Webdienst Methode löst möglich SoapException erweise eine aus, wenn Clients mithilfe von SOAP aufruft.An XML Web service method might throw a SoapException when clients call using SOAP. Wenn ein XML-Webdienst den SoapExceptionauslöst, können andere Details über die ActorEigenschaften, Code und Detail hinzugefügt werden, die andernfalls nicht durch eine XML-Webdienst Methode festgelegt werden können, wenn ein anderer Ausnahmetyp 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()

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

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

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

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

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

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

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

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

Code

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

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.

(Geerbt von Exception)
Detail

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

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.

(Geerbt von Exception)
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.

(Geerbt von Exception)
InnerException

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

(Geerbt von Exception)
Lang

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

Message

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

(Geerbt von Exception)
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

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

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.

(Geerbt von Exception)
StackTrace

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

(Geerbt von Exception)
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

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

(Geerbt von Exception)

Methoden

Equals(Object)

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

(Geerbt von Object)
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.

(Geerbt von Exception)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)

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

GetType()

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

(Geerbt von Exception)
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)

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)

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)

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

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

(Geerbt von Object)
ToString()

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

(Geerbt von Exception)

Ereignisse

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.

(Geerbt von Exception)

Gilt für: