SoapException Třída

Reference

Definice

Obor názvů:: System.Web.Services.Protocols

Sestavení:: System.Web.Services.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje výjimku, která je vyvolána, když je volána metoda webové služby XML přes SOAP a dojde k výjimce.

public ref class SoapException : SystemException

public class SoapException : SystemException

[System.Serializable]
public class SoapException : SystemException

type SoapException = class
    inherit SystemException

[<System.Serializable>]
type SoapException = class
    inherit SystemException

Public Class SoapException
Inherits SystemException

Dědičnost: Object

Exception

SystemException
SoapException

Odvozené: System.Web.Services.Protocols.SoapHeaderException

Atributy: SerializableAttribute

Příklady

Následující příklad vyvolá SoapException objekt , kde metoda webové služby XML nastaví Detail vlastnost .

<%@ 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

Poznámky

Může SoapException být vyvolán modulem CLR (Common Language Runtime) nebo metodou webové služby XML. Modul CLR (Common Language Runtime) může vyvolat chybu , SoapException pokud odpověď na požadavek není správně naformátovaná. Metody webové služby XML mohou generovat SoapException jednoduše vyvoláním výjimky v rámci metody webové služby XML. Pokud klient přistupoval k metodě přes SOAP, výjimka se zachytí na serveru a zabalí se do nového SoapException. Vyvolaný SoapException má následující hodnoty vlastností:

Vlastnost	Hodnota
Message	Vlastnost Message původní výjimky.
Code	ServerFaultCode.
Actor	Adresa URL metody webové služby XML.
Detail	`null`, ale v elementu fault je přítomen prázdný prvek detail.

Metoda webové služby XML může vyvolat chybu SoapException , když klienti volají pomocí protokolu SOAP. Pokud webová služba XML vyvolá , mohou být přidány SoapExceptiondalší podrobnosti prostřednictvím Actora vlastnosti, Code Detail které jinak nelze nastavit metodou webové služby XML, pokud je vyvolán jiný typ výjimky.

Konstruktory

SoapException()	Inicializuje novou instanci SoapException třídy .
SoapException(SerializationInfo, StreamingContext)	Inicializuje novou instanci třídy SoapException se serializovanými daty.
SoapException(String, XmlQualifiedName)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce a kódem výjimky.
SoapException(String, XmlQualifiedName, Exception)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky a odkazem na původní příčinu výjimky.
SoapException(String, XmlQualifiedName, SoapFaultSubCode)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky a podkódem.
SoapException(String, XmlQualifiedName, String)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky a identifikátorem URI, který identifikuje část kódu, která výjimku způsobila.
SoapException(String, XmlQualifiedName, String, Exception)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky, identifikátorem URI, který identifikuje kód, který způsobil výjimku, a odkazem na původní příčinu výjimky.
SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception)	Inicializuje novou instanci SoapException třídy se zadanou zprávou výjimky, kódem výjimky, identifikátorem URI, který identifikuje část kódu, která způsobila výjimku, identifikátorem URI, který představuje funkci webové služby XML při zpracování zprávy SOAP, lidský jazyk přidružený k výjimce, informace o výjimce specifické pro aplikaci, podkód pro chybu SOAP a odkaz na původní příčinu výjimky.
SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky, identifikátorem URI, který identifikuje část kódu, která způsobila výjimku, informace o výjimce specifické pro aplikaci a odkaz na původní příčinu výjimky.
SoapException(String, XmlQualifiedName, String, XmlNode)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky, identifikátorem URI, který identifikuje část kódu, která způsobila výjimku, a informacemi o výjimce specifické pro aplikaci.
SoapException(String, XmlQualifiedName, String, XmlNode, Exception)	Inicializuje novou instanci SoapException třídy se zadanou zprávou o výjimce, kódem výjimky, identifikátorem URI, který identifikuje část kódu, která způsobila výjimku, informace o výjimce specifické pro aplikaci a odkaz na původní příčinu výjimky.

Pole

ClientFaultCode	Určuje kód chyby SOAP, který představuje volání klienta, které není správně naformátováno nebo neobsahuje příslušné informace.
DetailElementName	Získá , XmlQualifiedName který představuje Detail prvek soap kód chyby.
MustUnderstandFaultCode	Kód chyby SOAP, který představuje element SOAP označený atributem `MustUnderstand` , nebyl zpracován.
ServerFaultCode	Určuje, že při zpracování volání klienta na serveru došlo k chybě soap, který představuje chybu, a problém není způsoben obsahem zprávy.
VersionMismatchFaultCode	Během zpracování zprávy SOAP byl nalezen kód chyby SOAP, který představuje neplatný obor názvů pro obálku SOAP.

Vlastnosti

Actor	Získá část kódu, která způsobila výjimku.
Code	Získá typ kódu chyby SOAP.
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
Detail	Získá, XmlNode který představuje informace o chybě specifické pro aplikaci podrobnosti.
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovaná číselná hodnota, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Lang	Získá lidský jazyk přidružený k výjimce.
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Node	Získá identifikátor URI, který představuje část kódu, která způsobila výjimku.
Role	Získá identifikátor URI, který představuje funkci webové služby XML při zpracování zprávy SOAP.
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcovou reprezentaci okamžitých rámců v zásobníku volání. (Zděděno od Exception)
SubCode	Získává volitelné informace o chybě obsažené v element XML `subcode` chyby SOAP.
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí hodnotu Exception , která je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Nastaví s SerializationInfo informacemi o výjimce.
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví s SerializationInfo informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
IsClientFaultCode(XmlQualifiedName)	Vrátí hodnotu, která označuje, zda je kód chyby SOAP ekvivalentní `Client` kódu chyby SOAP bez ohledu na verzi použitého protokolu SOAP.
IsMustUnderstandFaultCode(XmlQualifiedName)	Vrátí hodnotu, která označuje, zda je kód chyby SOAP ekvivalentní `MustUnderstand` bez ohledu na verzi použitého protokolu SOAP.
IsServerFaultCode(XmlQualifiedName)	Vrátí hodnotu, která označuje, zda je kód chyby SOAP ekvivalentní `Server` kódu chyby SOAP bez ohledu na verzi použitého protokolu SOAP.
IsVersionMismatchFaultCode(XmlQualifiedName)	Vrátí hodnotu, která označuje, zda je kód chyby SOAP ekvivalentní `VersionMismatch` kódu chyby SOAP bez ohledu na verzi použitého protokolu SOAP.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

SerializeObjectState

Zastaralé.

Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce.

(Zděděno od Exception)

Platí pro

Sdílet prostřednictvím