SoapHeader.MustUnderstand Vlastnost

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Získá nebo nastaví hodnotu označující, zda SoapHeader musí být srozumitelný.

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

Hodnota vlastnosti

Boolean

true pokud webová služba XML musí správně interpretovat a zpracovávat SoapHeader; jinak , false. Výchozí hodnota je false.

Příklady

Následující klient webové služby XML definuje vlastní hlavičku SOAP typu MyHeader, nastaví MustUnderstand vlastnost na truea vyvolá metodu MyWebMethod webové služby XML. Pokud metoda webové služby XML nenastaví DidUnderstand vlastnost hlavičky MyHeadertrueSOAP , SoapHeaderException je vyvolán.

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

Poznámky

Když klient webové služby XML přidá hlavičku SOAP do volání metody webové služby XML s MustUnderstand nastavenou vlastností true, musí metoda webové služby XML nastavit DidUnderstand vlastnost na true; jinak SoapHeaderException je vyvolán zpět do klienta webové služby XML ASP.NET.

I když lze k nastavení hodnoty atributu mustUnderstand v hlavičce SOAP použít obě vlastnosti EncodedMustUnderstandMustUnderstand, MustUnderstand vlastnost umožňuje nastavit atribut pomocí logické hodnoty.

Podrobnosti o přidávání hlaviček SOAP do klientů najdete v tématu Použití hlaviček PROTOKOLU SOAP.

Viz také

• DidUnderstand
• SoapHeaderException