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 je třeba porozumět.

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

truepokud webová služba XML musí správně interpretovat a zpracovat SoapHeader; v opačném případě . false Výchozí formát 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 MyHeader SOAP na true, 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 volání metody webové služby XML s MustUnderstand vlastností nastavenou na 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.

Ačkoli vlastnosti EncodedMustUnderstand a MustUnderstand lze použít k nastavení hodnoty atributu mustUnderstand v hlavičce SOAP, 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 SOAP.

Viz také

• DidUnderstand
• SoapHeaderException