SoapException Sınıf

Tanım

BIR XML Web hizmeti yöntemi SOAP üzerinden çağrıldığında ve bir özel durum oluştuğunda oluşan özel durumu temsil eder.

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
Devralma
Türetilmiş
Öznitelikler

Örnekler

Aşağıdaki örnek, XML Web hizmeti yönteminin özelliğini ayarladığı Detail bir SoapException oluşturur.

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

Açıklamalar

ortak SoapException dil çalışma zamanı tarafından veya bir XML Web hizmeti yöntemi tarafından oluşturulabilir. bir isteğe verilen yanıt doğru biçimlendirilmediyse ortak dil çalışma zamanı bir oluşturabilir SoapException . XML Web hizmeti yöntemleri, XML Web hizmeti yöntemi içinde bir özel durum oluşturarak oluşturabilir SoapException . İstemci yöntemine SOAP üzerinden erişirse, özel durum sunucuda yakalanıp yeni SoapExceptionbir içine sarmalanır. oluşturulan SoapException aşağıdaki özellik değerlerine sahiptir:

Özellik Değer
Message Message Özgün özel durumun özelliği.
Code ServerFaultCode.
Actor XML Web hizmeti yönteminin URL'si.
Detail null, ancak hata öğesinde boş bir ayrıntı öğesi bulunur.

İstemciler SOAP kullanarak çağırdığında XML Web hizmeti yöntemi bir SoapException atabilir. BIR XML Web hizmeti tarafından oluşturulursaSoapException, diğer ayrıntılar aracılığıyla Code eklenebilir Actorve Detail başka bir özel durum türü oluşturulursa xml web hizmeti yöntemi tarafından ayarlanamayan özellikler.

Oluşturucular

SoapException()

SoapException sınıfının yeni bir örneğini başlatır.

SoapException(SerializationInfo, StreamingContext)

SoapException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.

SoapException(String, XmlQualifiedName)

Belirtilen özel durum iletisi ve özel durum koduyla sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, Exception)

Belirtilen özel durum iletisi, özel durum kodu ve özel durumun kök nedeni başvurusu ile sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, SoapFaultSubCode)

Belirtilen özel durum iletisi, özel durum kodu ve alt kod ile sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, String)

Belirtilen özel durum iletisi, özel durum kodu ve özel duruma neden olan kod parçasını tanımlayan URI ile sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, String, Exception)

Belirtilen özel durum iletisi, özel durum kodu, özel duruma neden olan kodu tanımlayan URI ve özel durumun kök nedenine başvuru ile sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception)

Sınıfın SoapException yeni bir örneğini belirtilen özel durum iletisi, özel durum kodu, özel duruma neden olan kod parçasını tanımlayan URI, SOAP iletisini işlerken XML Web hizmetinin işlevini temsil eden URI, özel durumla ilişkili insan dili, uygulamaya özgü özel durum bilgileri, SOAP hatasının alt kodu ve özel durumun kök nedeni başvurusu ile başlatır.

SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception)

Belirtilen özel durum iletisi, özel durum kodu, özel duruma neden olan kod parçasını tanımlayan URI, uygulamaya özgü özel durum bilgileri ve özel durumun kök nedenine başvuru ile sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, String, XmlNode)

Belirtilen özel durum iletisi, özel durum kodu, özel duruma neden olan kod parçasını tanımlayan URI ve uygulamaya özgü özel durum bilgileriyle sınıfının yeni bir örneğini SoapException başlatır.

SoapException(String, XmlQualifiedName, String, XmlNode, Exception)

Belirtilen özel durum iletisi, özel durum kodu, özel duruma neden olan kod parçasını tanımlayan URI, uygulamaya özgü özel durum bilgileri ve özel durumun kök nedenine başvuru ile sınıfının yeni bir örneğini SoapException başlatır.

Alanlar

ClientFaultCode

Doğru biçimlendirilmemiş veya uygun bilgileri içermeyen bir istemci çağrısını temsil eden bir SOAP hata kodunu belirtir.

DetailElementName

XmlQualifiedName SOAP Hata kodunun Detail öğesini temsil eden bir alır.

MustUnderstandFaultCode

özniteliğiyle MustUnderstand işaretlenmiş bir SOAP öğesini temsil eden BIR SOAP Hata Kodu işlenmedi.

ServerFaultCode

Bir hatayı temsil eden SOAP hata kodunun, sorunun ileti içeriğinden kaynaklanmadığı sunucuda bir istemci çağrısı işlenirken oluştuğunu belirtir.

VersionMismatchFaultCode

SOAP iletisinin işlenmesi sırasında SOAP zarfı için geçersiz bir ad alanını temsil eden bir SOAP hata kodu bulundu.

Özellikler

Actor

Özel duruma neden olan kod parçasını alır.

Code

SOAP hata kodunun türünü alır.

Data

Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan bir anahtar/değer çifti koleksiyonu alır.

(Devralındığı yer: Exception)
Detail

Uygulamaya özgü hata bilgileri ayrıntılarını temsil eden bir XmlNode alır.

HelpLink

Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT'u alır veya ayarlar.

(Devralındığı yer: Exception)
InnerException

Exception Geçerli özel duruma neden olan örneği alır.

(Devralındığı yer: Exception)
Lang

Özel durumla ilişkili insan dilini alır.

Message

Geçerli özel durumu açıklayan bir ileti alır.

(Devralındığı yer: Exception)
Node

Özel duruma neden olan kod parçasını temsil eden bir URI alır.

Role

SOAP iletisini işlerken XML Web hizmetinin işlevini temsil eden bir URI alır.

Source

Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır.

(Devralındığı yer: Exception)
SubCode

SOAP hatasının XML öğesinde subcode bulunan isteğe bağlı hata bilgilerini alır.

TargetSite

Geçerli özel durumu oluşturan yöntemini alır.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan değerini döndürür Exception .

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo öğesini özel durumla ilgili bilgilerle ayarlar.

GetObjectData(SerializationInfo, StreamingContext)
Geçersiz.

Türetilmiş bir sınıfta geçersiz kılındığında, özel durumla ilgili bilgilerle öğesini SerializationInfo ayarlar.

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.

(Devralındığı yer: Exception)
IsClientFaultCode(XmlQualifiedName)

SOAP hata kodunun, kullanılan SOAP protokolünün sürümünden Client bağımsız olarak SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.

IsMustUnderstandFaultCode(XmlQualifiedName)

SOAP hata kodunun, kullanılan SOAP protokolünün sürümüne MustUnderstand bakılmaksızın eşdeğer olup olmadığını gösteren bir değer döndürür.

IsServerFaultCode(XmlQualifiedName)

SOAP hata kodunun, kullanılan SOAP protokolünün sürümünden Server bağımsız olarak SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.

IsVersionMismatchFaultCode(XmlQualifiedName)

SOAP hata kodunun, kullanılan SOAP protokolünün sürümünden VersionMismatch bağımsız olarak SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState
Geçersiz.

Bir özel durum, özel durum hakkında serileştirilmiş veriler içeren bir özel durum nesnesi oluşturmak üzere seri hale getirildiğinde gerçekleşir.

(Devralındığı yer: Exception)

Şunlara uygulanır