Bagikan melalui

SoapHeader.MustUnderstand Properti

  • Referensi

Definisi

Ruang nama:
System.Web.Services.Protocols
Rakitan:
System.Web.Services.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah SoapHeader harus dipahami.

public:
 property bool MustUnderstand { bool get(); void set(bool value); };
public bool MustUnderstand { get; set; }
member this.MustUnderstand : bool with get, set
Public Property MustUnderstand As Boolean

Nilai Properti

Boolean

true jika layanan Web XML harus menginterpretasikan SoapHeaderdan memproses dengan benar ; jika tidak, false. Default adalah false.

Contoh

Klien layanan Web XML berikut mendefinisikan header SOAP kustom jenis MyHeader, mengatur MustUnderstand properti ke true, dan memanggil MyWebMethod metode layanan Web XML. 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 MustUnderstand properti yang diatur ke true, metode layanan Web XML harus mengatur DidUnderstand properti ke true; jika tidak, SoapHeaderException akan dilemparkan kembali ke klien layanan Web XML dengan ASP.NET.

EncodedMustUnderstand Meskipun properti dan MustUnderstand dapat digunakan untuk mengatur nilai mustUnderstand atribut dalam header SOAP, MustUnderstand properti memungkinkan Anda mengatur atribut menggunakan nilai Boolean.

Untuk detail tentang menambahkan header SOAP ke klien, lihat Menggunakan Header SOAP.

Berlaku untuk

Lihat juga