SoapHeader.DidUnderstand Vlastnost

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Získá nebo nastaví hodnotu určující, zda metoda webové služby XML správně zpracovala hlavičku SOAP.

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

Hodnota vlastnosti

Boolean

true pokud byla hlavička SOAP správně zpracována; jinak false.

Příklady

Následující MyWebService webová služba XML definuje hlavičku MyHeader SOAP a vyžaduje, aby byla odeslána se všemi voláními MyWebMethod metody webové služby XML. Kromě toho MyWebMethod přijímá všechny hlavičky SOAP jiné než hlavičky MyHeader SOAP. Pro hlavičky SOAP, které MyWebMethod lze zpracovat, DidUnderstand je nastavena na 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

Poznámky

U hlaviček SOAP definovaných webovou službou XML ASP.NET předpokládá, že metoda webové služby XML správně zpracovala hlavičku SOAP nastavením počáteční hodnoty DidUnderstand na true. U hlaviček SOAP, které webová služba XML nedefinuje, je falsepočáteční hodnota . Pokud ASP.NET zjistí hlavičky SOAP předané metodě webové služby XML s DidUnderstand nastavenou na po false vrácení metody, SoapHeaderException vyvolá se zpět do klienta webové služby XML místo výsledků z metody webové služby XML.

Viz také

• MustUnderstand
• SoapHeaderException