SoapHeader.MustUnderstand Eigenschap

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

Waarde van eigenschap

trueals de XML-webservice de SoapHeader; anders moet interpreteren en verwerken. false De standaardwaarde is false.

Voorbeelden

De volgende XML-webserviceclient definieert een aangepaste SOAP-header van het type MyHeader, stelt de MustUnderstand eigenschap truein op en roept de MyWebMethod XML-webservicemethode aan. Als de XML-webservicemethode de DidUnderstand eigenschap van de MyHeader SOAP-header trueniet instelt op , wordt er een SoapHeaderException gegenereerd.

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

Opmerkingen

Wanneer een XML-webserviceclient een SOAP-header toevoegt aan een XML-webservicemethodeaanroep met de eigenschap MustUnderstand ingesteld op true, moet de xml-webservicemethode de eigenschap DidUnderstand instellen op true; anders wordt een SoapHeaderException teruggegooid naar de XML-webserviceclient door ASP.NET.

Hoewel zowel de als MustUnderstand de EncodedMustUnderstand eigenschappen kunnen worden gebruikt om de waarde van het mustUnderstand kenmerk in de SOAP-header in te stellen, kunt u met de MustUnderstand eigenschap het kenmerk instellen met behulp van een Boole-waarde.

Zie SOAP-headers gebruiken voor meer informatie over het toevoegen van SOAP-headers aan clients.

Zie ook

• DidUnderstand
• SoapHeaderException