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

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.
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

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)