SoapException SoapException SoapException SoapException Class

Definizione

Rappresenta l'eccezione generata quando viene chiamato un metodo di servizio Web XML attraverso 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 genera una SoapException in cui il metodo del servizio Web XML imposta il Detail proprietà.The following example throws a SoapException where the XML Web service method sets the Detail property.

Commenti

Il SoapException possono essere generate da 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. Common language runtime può generare un SoapException 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 generare un SoapException semplicemente generando un'eccezione all'interno di Web XML metodo del servizio.XML Web service methods can generate a SoapException by simply throwing an exception within the XML Web service method. Se il client di accedere al metodo tramite SOAP, l'eccezione viene rilevata nel server e incapsulato all'interno di un nuovo SoapException.If the client accessed the method over SOAP, the exception is caught on the server and wrapped inside a new SoapException. Il SoapException generata ha i valori delle proprietà seguenti:The SoapException thrown has the following property values:

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

Un metodo di servizio Web XML può generare un SoapException quando i client chiamano tramite SOAP.An XML Web service method might throw a SoapException when clients call using SOAP. Se un servizio Web XML genera i SoapException, è possono aggiungere altri dettagli tramite il Actor, Code e Detail metodo del servizio le proprietà che in caso contrario, non possono essere impostate tramite un Web XML, se un altro tipo di eccezione viene generato.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 di SoapException classe con il messaggio di eccezione specificato e il codice di eccezione.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 di SoapException classe con il messaggio di eccezione specificato, il codice di eccezione e il riferimento alla causa radice dell'eccezione.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 di eccezione, il codice eccezione e il codice secondario 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 di SoapException classe con il messaggio di eccezione specificato, il codice di eccezione e l'URI che identifica il frammento di codice che ha causato l'eccezione.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 di SoapException classe con il messaggio di eccezione specificata, il codice di eccezione, URI che identifica il codice che ha causato l'eccezione 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 i valori specificati per messaggio di eccezione, codice di eccezione, URI che identifica il frammento di codice che ha causato l'eccezione, informazioni sull'eccezione specifiche dell'applicazione 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, 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 di SoapException messaggi per classe con l'eccezione specificata, codice di eccezione, URI che identifica il frammento di codice che ha causato l'eccezione e 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 i valori specificati per messaggio di eccezione, codice di eccezione, URI che identifica il frammento di codice che ha causato l'eccezione, informazioni sull'eccezione specifiche dell'applicazione 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, application-specific exception information, and reference to the root cause of the exception.

Campi

ClientFaultCode ClientFaultCode ClientFaultCode ClientFaultCode

Specifica un codice di errore SOAP che rappresenta una chiamata del client che non è 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' XmlQualifiedName che rappresenta il Detail elemento di un codice di errore SOAP.Gets an XmlQualifiedName that represents the Detail element of a SOAP Fault code.

MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode MustUnderstandFaultCode

Codice di errore SOAP che rappresenta un elemento SOAP contrassegnato con il MustUnderstand attributo 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 che 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

Durante l'elaborazione del messaggio SOAP è stato trovato un codice di errore SOAP che rappresenta uno spazio dei nomi non valido per un elemento envelope 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

Ottiene il frammento di codice che ha causato l'eccezione.Gets the piece of code that caused the exception.

Code Code Code Code

Ottiene il tipo di codice di errore SOAP.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 XmlNode che rappresenta i dettagli sull'errore specifico 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 frammento di 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 subcode XML 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 Client codice di errore SOAP 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 Server codice di errore SOAP 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 VersionMismatch codice di errore SOAP 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