SoapHeader.DidUnderstand Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der angibt, ob eine XML-Webdienstmethode einen SOAP-Header richtig verarbeitet hat, oder legt diesen Wert fest.

public:
 property bool DidUnderstand { bool get(); void set(bool value); };
public bool DidUnderstand { get; set; }
member this.DidUnderstand : bool with get, set
Public Property DidUnderstand As Boolean

Eigenschaftswert

Boolean

true, wenn der SOAP-Header richtig verarbeitet wurde, andernfalls false.

Beispiele

Der folgende MyWebService XML-Webdienst definiert den MyHeader SOAP-Header und erfordert, dass er mit allen Aufrufen an die MyWebMethod XML-Webdienstmethode gesendet werden muss. Darüber hinaus empfängt der MyWebMethod SOAP-Header andere SOAP-Header als den MyHeader SOAP-Header. Für SOAP-Header, die MyWebMethod verarbeitet werden können, DidUnderstand wird auf true".

<%@ WebService Language="C#" Class="MyWebService"%>
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System;

// Define a SOAP header by deriving from the SoapHeader base class.

public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;
    // Receive all SOAP headers besides the MyHeader SOAP header.
    public SoapUnknownHeader[] unknownHeaders;
 
    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]

    //Receive any SOAP headers other than MyHeader.
    [SoapHeader("unknownHeaders",Required=false)]

    public string MyWebMethod() {

       foreach (SoapUnknownHeader header in unknownHeaders) {
           // Perform some processing on the header.
       if (header.Element.Name == "MyKnownHeader")
               header.DidUnderstand = true;
       else
                // For those headers that cannot be  
                // processed, set the DidUnderstand property to false.
                header.DidUnderstand = false;
       }
       return "Hello";
    }
}

<%@ WebService Language="VB" Class="MyWebService"%>

Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml
Imports System

' Define a SOAP header by deriving from the SoapHeader base class.
Public Class MyHeader
    Inherits SoapHeader
    Public MyValue As String
End Class

Public Class MyWebService
    
    Public theHeader As MyHeader
    ' Receive all SOAP headers besides the MyHeader SOAP header.
    Public unknownHeaders() As SoapUnknownHeader    

    'Receive any SOAP headers other than MyHeader.    
    <WebMethod, _
     SoapHeader("theHeader", Direction := SoapHeaderDirection.InOut), _
     SoapHeader("unknownHeaders")> _
    Public Function MyWebMethod() As String
                
        Dim header As SoapUnknownHeader
        For Each header In unknownHeaders
            ' Perform some processing on the header.
            If header.Element.Name = "MyKnownHeader" Then
                header.DidUnderstand = True
            Else
                ' For those headers that cannot be
                ' processed, set the DidUnderstand propert to false.
                header.DidUnderstand = False
            End If
        Next header
        Return "Hello"
    End Function
    
End Class

Hinweise

Bei SOAP-Headern, die von einem XML-Webdienst definiert sind, wird ASP.NET davon ausgegangen, dass die XML-Webdienstmethode den SOAP-Header ordnungsgemäß verarbeitet hat, indem Sie den Anfangswert DidUnderstand trueauf festlegen. Für SOAP-Header, die nicht vom XML-Webdienst definiert sind, lautet falseder Initialwert . Wenn ASP.NET SOAP-Header erkennt, die an eine XML-Webdienstmethode übergeben werden, DidUnderstand die nach der Rückgabe der Methode festgelegt false ist, wird eine SoapHeaderException zurück in den XML-Webdienstclient anstelle der Ergebnisse aus der XML-Webdienstmethode ausgelöst.

Gilt für

Siehe auch