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 SoapHeader doit être compris.

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 correctement interpréter et traiter 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é sur trueet 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 MyHeader SOAP sur true, un SoapHeaderException 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 est renvoyé au client de service Web XML par ASP.NET.

Bien que les EncodedMustUnderstand propriétés et MustUnderstand puissent être utilisées pour définir la valeur de l’attribut dans l’en-tête mustUnderstand 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 d’en-têtes SOAP.

Voir aussi

• DidUnderstand
• SoapHeaderException