SoapHeader.MustUnderstand Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit une valeur indiquant si la SoapHeader valeur doit être comprise.

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

Valeur de propriété

Boolean

true si le service Web XML doit interpréter et traiter correctement le SoapHeader; sinon, false. La valeur par défaut est false.

Exemples

Le client de service Web XML suivant définit un en-tête SOAP personnalisé de type MyHeader, définit la MustUnderstand propriété truesur et appelle la méthode de MyWebMethod service Web XML. Si la méthode de service Web XML ne définit pas la DidUnderstand propriété de l’en-tête MyHeadertrueSOAP sur , une SoapHeaderException valeur est levée.

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

Remarques

Lorsqu’un client de service Web XML ajoute un en-tête SOAP à un appel de méthode de service Web XML avec la MustUnderstand propriété définie truesur , la méthode de service Web XML doit définir la DidUnderstand propriété truesur ; sinon, un SoapHeaderException retour au client de service Web XML est renvoyé au client de service Web XML par ASP.NET.

Bien que les propriétés et MustUnderstand les EncodedMustUnderstand propriétés puissent être utilisées pour définir la valeur de l’attribut mustUnderstand dans l’en-tête SOAP, la MustUnderstand propriété vous permet de définir l’attribut à l’aide d’une valeur booléenne.

Pour plus d’informations sur l’ajout d’en-têtes SOAP aux clients, consultez Utilisation des en-têtes SOAP.

Voir aussi

• DidUnderstand
• SoapHeaderException