SoapHeaderException Kelas

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Representasi SOAP dari kesalahan server.

public ref class SoapHeaderException : System::Web::Services::Protocols::SoapException

[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapException

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

Public Class SoapHeaderException
Inherits SoapException

Warisan

Object

Exception

SystemException

SoapException

SoapHeaderException

Atribut

SerializableAttribute

Contoh

Dalam contoh berikut, klien layanan Web XML memanggil MyWebMethod metode layanan Web XML, meneruskan header SOAP jenis MyHeader dengan properti diatur MustUnderstand ke true. Jika metode layanan Web XML tidak mengatur DidUnderstand properti MyHeader header SOAP ke true, akan SoapHeaderException dilemparkan.

int main()
{
   MyWebService^ ws = gcnew MyWebService;
   try
   {
      MyHeader^ customHeader = gcnew MyHeader;
      customHeader->MyValue = "Header Value for MyValue";
      customHeader->MustUnderstand = true;
      ws->myHeader = customHeader;
      int results = ws->MyWebMethod( 3, 5 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e );
   }

}

using System;

public class Sample {

    public static void Main() {
        MyWebService ws = new MyWebService();

        try {
            MyHeader customHeader = new MyHeader();
            customHeader.MyValue = "Header Value for MyValue";
            customHeader.MustUnderstand = true;
            ws.myHeader = customHeader;

        int results = ws.MyWebMethod(3,5);
        }
        catch (Exception e) {
            Console.WriteLine ("Exception: {0}", e.ToString());
        }
    }
}

Public Class Sample
    
    Public Shared Sub Main()
        Dim ws As New MyWebService()

        Try
            Dim customHeader As New MyHeader1()

            customHeader.MyValue = "Header Value for MyValue"
            customHeader.MustUnderstand = True

            ws.myHeader = customHeader

        Dim results As Integer

            results = ws.MyWebMethod(3,5)
        Catch e As Exception
            Console.WriteLine("Exception: {0}", e.ToString())
        End Try
    End Sub
End Class

Keterangan

Ketika klien layanan Web XML menambahkan header SOAP ke panggilan metode layanan Web XML dengan properti yang MustUnderstand diatur ke true, metode layanan Web XML harus mengatur properti ke trueDidUnderstand ; jika tidak, akan SoapHeaderException dilemparkan.

Properti Detail tidak dapat diatur sesuai dengan spesifikasi SOAP untuk .SoapHeaderException

Nota

Aplikasi yang menggunakan spesifikasi SOAP 1.1 sebagai protokol layanan dapat menggunakan SoapHeaderException untuk mengakses kesalahan SOAP. Namun, aplikasi yang menggunakan spesifikasi SOAP 1.2 harus menggunakan SoapException untuk mengakses kesalahan SOAP.

Konstruktor

Nama	Deskripsi
SoapHeaderException()	Menginisialisasi instans baru dari kelas SoapHeaderException.
SoapHeaderException(SerializationInfo, StreamingContext)	Menginisialisasi instans SoapHeaderException baru kelas dengan parameter untuk mengontrol serialisasi.
SoapHeaderException(String, XmlQualifiedName, Exception)	Menginisialisasi instans baru dari kelas SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, String, Exception)	Menginisialisasi instans baru dari kelas SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName, String, String, SoapFaultSubCode, Exception)	Menginisialisasi instans SoapHeaderException baru kelas dengan data terkait.
SoapHeaderException(String, XmlQualifiedName, String, String, String, SoapFaultSubCode, Exception)	Menginisialisasi instans SoapHeaderException baru kelas dengan data terkait.
SoapHeaderException(String, XmlQualifiedName, String)	Menginisialisasi instans baru dari kelas SoapHeaderException.
SoapHeaderException(String, XmlQualifiedName)	Menginisialisasi instans baru dari kelas SoapHeaderException.

Properti

Nama	Deskripsi
Actor	Mendapatkan bagian kode yang menyebabkan pengecualian. (Diperoleh dari SoapException)
Code	Mendapatkan jenis kode kesalahan SOAP. (Diperoleh dari SoapException)
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. (Diperoleh dari SoapException)
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. (Diperoleh dari SoapException)
Message	Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception)
Node	Mendapatkan URI yang mewakili bagian kode yang menyebabkan pengecualian. (Diperoleh dari SoapException)
Role	Mendapatkan URI yang mewakili fungsi layanan Web XML dalam memproses pesan SOAP. (Diperoleh dari SoapException)
Source	Mendapatkan atau mengatur 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. (Diperoleh dari SoapException)
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Ketika ditimpa di kelas turunan, mengembalikan Exception 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. (Diperoleh dari SoapException)
GetType()	Mendapatkan jenis runtime instans saat ini. (Diperoleh dari Exception)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Membuat dan mengembalikan representasi string dari pengecualian saat ini. (Diperoleh dari Exception)

Acara

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

Lihat juga

• MustUnderstand
• DidUnderstand
• SoapHeader
• SoapException