SoapHeader.MustUnderstand Właściwość

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Pobiera lub ustawia wartość wskazującą, czy SoapHeader element musi być zrozumiały.

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

Wartość właściwości

Boolean

true jeśli usługa sieci Web XML musi prawidłowo interpretować i przetwarzać SoapHeaderelement ; w przeciwnym razie false. Wartość domyślna to false.

Przykłady

Następujący klient usługi sieci Web XML definiuje niestandardowy nagłówek protokołu SOAP typu MyHeader, ustawia MustUnderstand właściwość na true, i wywołuje metodę MyWebMethod usługi sieci Web XML. Jeśli metoda usługi sieci Web XML nie ustawia DidUnderstand właściwości nagłówka MyHeader SOAP na true, SoapHeaderException zostanie zgłoszony.

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

Uwagi

Gdy klient usługi sieci Web XML dodaje nagłówek SOAP do wywołania metody usługi sieci Web XML z MustUnderstand właściwością ustawioną na true, metoda usługi sieci Web XML musi ustawić DidUnderstand właściwość na true; w przeciwnym razie SoapHeaderException element jest zwracany do klienta usługi sieci Web XML przez ASP.NET.

Chociaż właściwości EncodedMustUnderstand i MustUnderstand mogą służyć do ustawiania wartości mustUnderstand atrybutu w nagłówku protokołu SOAP, MustUnderstand właściwość umożliwia ustawienie atrybutu przy użyciu wartości logicznej.

Aby uzyskać szczegółowe informacje na temat dodawania nagłówków protokołu SOAP do klientów, zobacz Using SOAP Headers (Używanie nagłówków protokołu SOAP).

Zobacz też

• DidUnderstand
• SoapHeaderException