SoapHeader.MustUnderstand Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.Services.Protocols
Assembly:
System.Web.Services.dll

Ruft einen Wert ab, der angibt, ob der SoapHeader verstanden werden muss, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn der XML-Webdienst den SoapHeader ordnungsgemäß interpretieren und verarbeiten muss. Andernfalls false. Der Standardwert ist false.

Beispiele

Der folgende XML-Webdienstclient definiert einen benutzerdefinierten SOAP-Header des TypsMyHeader, legt die Eigenschaft auf truefest, und ruft die MustUnderstand MyWebMethod XML-Webdienstmethode auf. Wenn die XML-Webdienstmethode die DidUnderstand Eigenschaft des MyHeader SOAP-Headers truenicht auf legt, wird eine SoapHeaderException ausgelöst.

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

Hinweise

Wenn ein XML-Webdienstclient einen SOAP-Header zu einem XML-Webdienstmethodenaufruf mit dem MustUnderstand Eigenschaftssatz truehinzufügt, muss die XML-Webdienstmethode die DidUnderstand Eigenschaft trueauf festlegen; andernfalls wird eine SoapHeaderException zurück in den XML-Webdienstclient durch ASP.NET ausgelöst.

Obwohl sowohl die Eigenschaften als auch die EncodedMustUnderstand MustUnderstand Eigenschaften verwendet werden können, um den Wert des Attributs innerhalb des mustUnderstand SOAP-Headers festzulegen, ermöglicht ihnen die MustUnderstand Eigenschaft, das Attribut mithilfe eines Boolean-Werts festzulegen.

Ausführliche Informationen zum Hinzufügen von SOAP-Headern zu Clients finden Sie unter Verwenden von SOAP-Headern.

Gilt für

Siehe auch