SoapHeader.MustUnderstand Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta un valore che indica se l'oggetto SoapHeader deve essere riconosciuto.

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

Valore della proprietà

Boolean

true se il servizio Web XML deve interpretare ed elaborare correttamente l'oggetto SoapHeader e false altrimenti. Il valore predefinito è false.

Esempio

Il client del servizio Web XML seguente definisce un'intestazione SOAP personalizzata di tipo MyHeader, imposta la proprietà su truee richiama il MustUnderstand metodo del MyWebMethod servizio Web XML. Se il metodo del servizio Web XML non imposta la DidUnderstand proprietà dell'intestazione MyHeader SOAP su true, viene generato un SoapHeaderException oggetto .

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

Commenti

Quando un client del servizio Web XML aggiunge un'intestazione SOAP a una chiamata al metodo di servizio Web XML con la MustUnderstand proprietà impostata su true, il metodo del servizio Web XML deve impostare la DidUnderstand proprietà truesu ; in caso contrario, viene SoapHeaderException generata un'intestazione al client del servizio Web XML da ASP.NET.

Anche se entrambe le EncodedMustUnderstand proprietà e MustUnderstand possono essere usate per impostare il valore dell'attributo all'interno dell'intestazione mustUnderstand SOAP, la MustUnderstand proprietà consente di impostare l'attributo usando un valore booleano.

Per informazioni dettagliate sull'aggiunta di intestazioni SOAP ai client, vedere Uso di intestazioni SOAP.

Vedi anche

• DidUnderstand
• SoapHeaderException