SoapException Sınıf

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

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

[System.Serializable]
public class SoapException : SystemException

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

Public Class SoapException
Inherits SystemException

Devralma

Object

Exception

SystemException

SoapException

Türetilmiş

System.Web.Services.Protocols.SoapHeaderException

Öznitelikler

SerializableAttribute

Ö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

SoapException, ortak dil çalışma zamanı veya XML Web hizmeti yöntemi tarafından oluşturulabilir. Ortak dil çalışma zamanı, SoapException bir isteğe verilen yanıt doğru biçimlendirilmediyse bir oluşturabilir. XML Web hizmeti yöntemleri, XML Web hizmeti yöntemi içinde bir özel durum oluşturarak bir 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:

Mülkiyet	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 bir SoapException XML Web hizmeti yöntemi bir atabilir. 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

Name	Description
SoapException()	SoapException sınıfının yeni bir örneğini başlatır.
SoapException(SerializationInfo, StreamingContext)	Serileştirilmiş verilerle 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, Exception)	Sınıfın SoapException yeni bir örneğini belirtilen özel durum iletisiyle, özel durum koduyla, özel duruma neden olan kodu tanımlayan URI'yle ve özel durumun kök nedenine başvuruyla 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 nedenini gösteren başvuru 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 nedeninin başvurusu ile sınıfı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 nedeninin başvurusu ile sınıfın yeni bir örneğini SoapException başlatır.
SoapException(String, XmlQualifiedName, String, XmlNode)	Sınıfın SoapException yeni bir örneğini belirtilen özel durum iletisiyle, özel durum koduyla, özel duruma neden olan kod parçasını tanımlayan URI'yle ve uygulamaya özgü özel durum bilgileriyle 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)	Belirtilen özel durum iletisi ve özel durum koduyla sınıfının yeni bir örneğini SoapException başlatır.

Alanlar

Name	Description
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 SOAP Hata Kodu işlenmedi.
ServerFaultCode	Bir hatayı temsil eden bir 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

Name	Description
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 anahtar/değer çiftleri koleksiyonunu 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 değerini 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

Name	Description
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.
GetType()	Geçerli örneğin çalışma zamanı türünü alır. (Devralındığı yer: Exception)
IsClientFaultCode(XmlQualifiedName)	KULLANıLAN SOAP protokolünün sürümünden bağımsız olarak SOAP hata kodunun Client SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.
IsMustUnderstandFaultCode(XmlQualifiedName)	KULLANıLAN SOAP protokolünün sürümünden bağımsız olarak SOAP hata kodunun eşdeğer MustUnderstand olup olmadığını gösteren bir değer döndürür.
IsServerFaultCode(XmlQualifiedName)	KULLANıLAN SOAP protokolünün sürümünden bağımsız olarak SOAP hata kodunun Server SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.
IsVersionMismatchFaultCode(XmlQualifiedName)	KULLANıLAN SOAP protokolünün sürümünden bağımsız olarak SOAP hata kodunun VersionMismatch SOAP hata koduyla eşdeğer olup olmadığını gösteren bir değer döndürür.
MemberwiseClone()	Geçerli Objectbasit 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

Name	Description
SerializeObjectState	Özel durum hakkında serileştirilmiş veriler içeren bir özel durum durumu nesnesi oluşturmak için bir özel durum seri hale getirildiğinde gerçekleşir. (Devralındığı yer: Exception)