SoapException Kelas

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Mewakili pengecualian yang dilemparkan ketika metode layanan Web XML dipanggil melalui SOAP dan pengecualian terjadi.

public ref class SoapException : SystemException

[System.Serializable]
public class SoapException : SystemException

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

Public Class SoapException
Inherits SystemException

Warisan

Object

Exception

SystemException

SoapException

Turunan

System.Web.Services.Protocols.SoapHeaderException

Atribut

SerializableAttribute

Contoh

Contoh berikut melempar SoapException tempat metode layanan Web XML mengatur Detail properti .

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

Keterangan

SoapException dapat dilemparkan oleh runtime bahasa umum atau dengan metode layanan Web XML. Runtime bahasa umum dapat melempar SoapException jika respons terhadap permintaan tidak diformat dengan benar. Metode layanan Web XML dapat menghasilkan SoapException hanya dengan melemparkan pengecualian dalam metode layanan Web XML. Jika klien mengakses metode melalui SOAP, pengecualian tertangkap di server dan dibungkus di dalam baru SoapException. Yang SoapException dilemparkan memiliki nilai properti berikut:

Properti	Nilai
Message	Properti Message pengecualian asli.
Code	ServerFaultCode.
Actor	URL metode layanan Web XML.
Detail	null, tetapi elemen detail kosong ada dalam elemen kesalahan.

Metode layanan Web XML mungkin melempar SoapException ketika klien memanggil menggunakan SOAP. Jika layanan Web XML melempar SoapException, detail lain dapat ditambahkan melalui Actorproperti , Code dan Detail yang tidak dapat diatur oleh metode layanan Web XML jika jenis pengecualian lain dilemparkan.

Konstruktor

SoapException()	Menginisialisasi instans baru kelas SoapException.
SoapException(SerializationInfo, StreamingContext)	Menginisialisasi instans SoapException baru kelas dengan data berseri.
SoapException(String, XmlQualifiedName)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian dan kode pengecualian yang ditentukan.
SoapException(String, XmlQualifiedName, Exception)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian, kode pengecualian, dan referensi yang ditentukan ke akar penyebab pengecualian.
SoapException(String, XmlQualifiedName, SoapFaultSubCode)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian, kode pengecualian, dan subkode yang ditentukan.
SoapException(String, XmlQualifiedName, String)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian, kode pengecualian, dan URI yang ditentukan yang mengidentifikasi bagian kode yang menyebabkan pengecualian.
SoapException(String, XmlQualifiedName, String, Exception)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian yang ditentukan, kode pengecualian, URI yang mengidentifikasi kode yang menyebabkan pengecualian, dan merujuk ke akar penyebab pengecualian.
SoapException(String, XmlQualifiedName, String, String, String, XmlNode, SoapFaultSubCode, Exception)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian yang ditentukan, kode pengecualian, URI yang mengidentifikasi bagian kode yang menyebabkan pengecualian, URI yang mewakili fungsi layanan Web XML dalam memproses pesan SOAP, bahasa manusia yang terkait dengan pengecualian, informasi pengecualian khusus aplikasi, subkode untuk kesalahan SOAP dan referensi ke akar penyebab pengecualian.
SoapException(String, XmlQualifiedName, String, String, XmlNode, SoapFaultSubCode, Exception)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian yang ditentukan, kode pengecualian, URI yang mengidentifikasi bagian kode yang menyebabkan pengecualian, informasi pengecualian khusus aplikasi, dan referensi ke akar penyebab pengecualian.
SoapException(String, XmlQualifiedName, String, XmlNode)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian yang ditentukan, kode pengecualian, URI yang mengidentifikasi bagian kode yang menyebabkan pengecualian, dan informasi pengecualian khusus aplikasi.
SoapException(String, XmlQualifiedName, String, XmlNode, Exception)	Menginisialisasi instans SoapException baru kelas dengan pesan pengecualian yang ditentukan, kode pengecualian, URI yang mengidentifikasi bagian kode yang menyebabkan pengecualian, informasi pengecualian khusus aplikasi, dan referensi ke akar penyebab pengecualian.

Bidang

ClientFaultCode	Menentukan kode kesalahan SOAP yang mewakili panggilan klien yang tidak diformat dengan benar atau tidak berisi informasi yang sesuai.
DetailElementName	XmlQualifiedName Mendapatkan yang mewakili Detail elemen kode Kesalahan SOAP.
MustUnderstandFaultCode	Kode Kesalahan SOAP yang mewakili elemen SOAP yang ditandai dengan MustUnderstand atribut tidak diproses.
ServerFaultCode	Menentukan bahwa kode kesalahan SOAP yang mewakili kesalahan terjadi selama pemrosesan panggilan klien di server, di mana masalahnya bukan karena konten pesan.
VersionMismatchFaultCode	Kode kesalahan SOAP yang mewakili namespace layanan yang tidak valid untuk amplop SOAP ditemukan selama pemrosesan pesan SOAP.

Properti

Actor	Mendapatkan bagian kode yang menyebabkan pengecualian.
Code	Mendapatkan jenis kode kesalahan SOAP.
Data	Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception)
Detail	XmlNode Mendapatkan yang mewakili detail informasi kesalahan khusus aplikasi.
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception)
HResult	Mendapatkan atau mengatur HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception)
InnerException	Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception)
Lang	Mendapatkan bahasa manusia yang terkait dengan pengecualian.
Message	Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception)
Node	Mendapatkan URI yang mewakili bagian kode yang menyebabkan pengecualian.
Role	Mendapatkan URI yang mewakili fungsi layanan Web XML dalam memproses pesan SOAP.
Source	Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception)
StackTrace	Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception)
SubCode	Mendapatkan informasi kesalahan opsional yang terkandung dalam subcode elemen XML dari kesalahan SOAP.
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Ketika ditimpa di kelas turunan Exception , mengembalikan yang merupakan akar penyebab dari satu atau beberapa pengecualian berikutnya. (Diperoleh dari Exception)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo Mengatur dengan informasi tentang pengecualian.
GetType()	Mendapatkan jenis runtime dari instans saat ini. (Diperoleh dari Exception)
IsClientFaultCode(XmlQualifiedName)	Mengembalikan nilai yang menunjukkan apakah kode kesalahan SOAP setara dengan Client kode kesalahan SOAP terlepas dari versi protokol SOAP yang digunakan.
IsMustUnderstandFaultCode(XmlQualifiedName)	Mengembalikan nilai yang menunjukkan apakah kode kesalahan SOAP setara dengan MustUnderstand terlepas dari versi protokol SOAP yang digunakan.
IsServerFaultCode(XmlQualifiedName)	Mengembalikan nilai yang menunjukkan apakah kode kesalahan SOAP setara dengan Server kode kesalahan SOAP terlepas dari versi protokol SOAP yang digunakan.
IsVersionMismatchFaultCode(XmlQualifiedName)	Mengembalikan nilai yang menunjukkan apakah kode kesalahan SOAP setara dengan VersionMismatch kode kesalahan SOAP terlepas dari versi protokol SOAP yang digunakan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Membuat dan mengembalikan representasi string dari pengecualian saat ini. (Diperoleh dari Exception)

Acara

SerializeObjectState

Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception)