SoapException SoapException SoapException SoapException Class

Definizione

Rappresenta l'eccezione generata quando un metodo del servizio Web XML viene chiamato su SOAP e si verifica un'eccezione.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
Ereditarietà
Derivato
Attributi

Esempi

Nell'esempio seguente viene generata SoapException un'eccezione in cui il metodo di servizio Detail Web XML imposta la proprietà.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

Commenti

SoapException Può essere generata dal Common Language Runtime o da un metodo di servizio Web XML.The SoapException can either be thrown by the common language runtime or by an XML Web service method. Il Common Language Runtime può generare un' SoapException istanza se una risposta a una richiesta non è formattata correttamente.The common language runtime can throw a SoapException if a response to a request is not formatted correctly. I metodi del servizio Web XML possono SoapException generare un oggetto semplicemente generando un'eccezione all'interno del metodo di servizio Web XML.XML Web service methods can generate a SoapException by simply throwing an exception within the XML Web service method. Se il client ha eseguito l'accesso al metodo tramite SOAP, l'eccezione viene rilevata nel server e SoapExceptionincapsulata all'interno di un nuovo oggetto.If the client accessed the method over SOAP, the exception is caught on the server and wrapped inside a new SoapException. L' SoapException oggetto generato presenta i valori di proprietà seguenti:The SoapException thrown has the following property values:

ProprietàProperty ValueValue
Message Message Proprietà dell'eccezione originale.The Message property of the original exception.
Code ServerFaultCode.ServerFaultCode.
Actor URL del metodo del servizio Web XML.The URL of the XML Web service method.
Detail null, ma nell'elemento fault è presente un elemento detail vuoto.null, but an empty detail element is present in the fault element.

Un metodo di servizio Web XML potrebbe generare SoapException un'eccezione quando i client chiamano utilizzando SOAP.An XML Web service method might throw a SoapException when clients call using SOAP. Se un servizio Web XML genera l' SoapExceptionoggetto, è possibile aggiungere altri dettagli tramite Actor Code le proprietà Detail e che non possono essere altrimenti impostate da un metodo di servizio Web XML se viene generato un altro tipo di eccezione.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.

Costruttori

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

Inizializza una nuova istanza della classe SoapException.Initializes a new instance of the SoapException class.

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

Inizializza una nuova istanza della classe SoapException con dati serializzati.Initializes a new instance of the SoapException class with serialized data.

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

Inizializza una nuova istanza della classe SoapException con il messaggio e il codice delle eccezioni specificati.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)

Inizializza una nuova istanza della classe SoapException con il messaggio di eccezione, il codice di eccezione e il riferimento alla causa radice dell'eccezione specificati.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)

Inizializza una nuova istanza della classe SoapException con il messaggio, il codice e il sottocodice delle eccezioni specificati.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)

Inizializza una nuova istanza della classe SoapException con il messaggio di eccezione, il codice di eccezione e l'URI che identifica la parte di codice che l'ha causata specificati.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)

Inizializza una nuova istanza della classe SoapException con specificati il messaggio di eccezione, il codice di eccezione, l'URI che identifica il codice che l'ha causata e il riferimento alla causa radice dell'eccezione.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)

Inizializza una nuova istanza della classe SoapException con i valori specificati per messaggio di eccezione, codice di eccezione, URI che identifica il frammento di codice che ha causato l'eccezione, URI che rappresenta la funzione del servizio Web XML durante l'elaborazione del messaggio SOAP, lingua associata all'eccezione, informazioni sull'eccezione specifiche dell'applicazione, codice secondario per l'errore SOAP e riferimento alla causa radice dell'eccezione.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)

Inizializza una nuova istanza della classe SoapException con specificati il messaggio di eccezione, il codice di eccezione, l'URI che identifica la parte di codice che l'ha causata, le informazioni relative all'eccezione specifiche dell'applicazione e il riferimento alla causa radice dell'eccezione.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)

Inizializza una nuova istanza della classe SoapException con specificati il messaggio di eccezione, il codice di eccezione, l'URI che identifica la parte di codice che l'ha causata e le informazioni sull'eccezione specifiche dell'applicazione.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)

Inizializza una nuova istanza della classe SoapException con specificati il messaggio di eccezione, il codice di eccezione, l'URI che identifica la parte di codice che l'ha causata, le informazioni relative all'eccezione specifiche dell'applicazione e il riferimento alla causa radice dell'eccezione.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.

Campi

ClientFaultCode ClientFaultCode ClientFaultCode ClientFaultCode

Specifica un codice di errore SOAP indicante che una chiamata client non è stata formattata correttamente o non contiene le informazioni appropriate.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

Ottiene un oggetto XmlQualifiedName che rappresenta l'elemento Detail di un codice di errore SOAP.Gets an XmlQualifiedName that represents the Detail element of a SOAP Fault code.

MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode

Un codice di errore SOAP che identifica un elemento SOAP contrassegnato con l'attributo MustUnderstand non è stato elaborato.A SOAP Fault Code that represents a SOAP element marked with the MustUnderstand attribute was not processed.

ServerFaultCode ServerFaultCode ServerFaultCode ServerFaultCode

Specifica un codice di errore SOAP che rappresenta un errore verificatosi durante l'elaborazione di una chiamata client sul server, in cui il problema non era dovuto al contenuto del messaggio.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

Codice di errore SOAP che rappresenta l'individuazione di uno spazio dei nomi non valido per un envelope SOAP durante l'elaborazione del messaggio SOAP.A SOAP fault code that represents an invalid namespace for a SOAP envelope was found during the processing of the SOAP message.

Proprietà

Actor Actor Actor Actor

Recupera la porzione di codice che ha causato l'eccezione.Gets the piece of code that caused the exception.

Code Code Code Code

Recupera il tipo di codice SOAP con errori.Gets the type of SOAP fault code.

Data Data Data Data

Ottiene una raccolta di coppie chiave-valore che fornisce informazioni aggiuntive definite dall'utente relative all'eccezione.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
Detail Detail Detail Detail

Ottiene un oggetto XmlNode che rappresenta i dettagli sull'errore specifici dell'applicazione.Gets an XmlNode that represents the application-specific error information details.

HelpLink HelpLink HelpLink HelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Lang Lang Lang Lang

Ottiene la lingua associata all'eccezione.Gets the human language associated with the exception.

Message Message Message Message

Ottiene un messaggio che descrive l'eccezione corrente.Gets a message that describes the current exception.

(Inherited from Exception)
Node Node Node Node

Ottiene un URI che rappresenta il codice che ha causato l'eccezione.Gets a URI that represents the piece of code that caused the exception.

Role Role Role Role

Ottiene un URI che rappresenta la funzione del servizio Web XML nell'elaborazione del messaggio SOAP.Gets a URI that represents the XML Web service's function in processing the SOAP message.

Source Source Source Source

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
SubCode SubCode SubCode SubCode

Ottiene le informazioni facoltative sull'errore contenute nell'elemento XML subcode di un errore SOAP.Gets the optional error information contained in the subcode XML element of a SOAP fault.

TargetSite TargetSite TargetSite TargetSite

Ottiene il metodo che genera l'eccezione corrente.Gets the method that throws the current exception.

(Inherited from Exception)

Metodi

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Se utilizzato come metodo di override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.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()

Funge da funzione hash predefinita.Serves as the default hash function.

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

Imposta l'oggetto SerializationInfo con le informazioni sull'eccezione.Sets the SerializationInfo with information about the exception.

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

Ottiene il tipo di runtime dell'istanza corrente.Gets the runtime type of the current instance.

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

Restituisce un valore che indica se il codice di errore SOAP equivale al codice di errore SOAP Client, indipendentemente dalla versione del protocollo SOAP utilizzata.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)

Restituisce un valore che indica se il codice di errore SOAP equivale a MustUnderstand, indipendentemente dalla versione del protocollo SOAP utilizzata.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)

Restituisce un valore che indica se il codice di errore SOAP equivale al codice di errore SOAP Server, indipendentemente dalla versione del protocollo SOAP utilizzata.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)

Restituisce un valore che indica se il codice di errore SOAP equivale al codice di errore SOAP VersionMismatch, indipendentemente dalla versione del protocollo SOAP utilizzata.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()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Eventi

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Si applica a