SoapHeader.DidUnderstand Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om en XML-webbtjänstmetod har bearbetat en SOAP-rubrik korrekt.
public:
property bool DidUnderstand { bool get(); void set(bool value); };public bool DidUnderstand { get; set; }member this.DidUnderstand : bool with get, setPublic Property DidUnderstand As BooleanEgenskapsvärde
true om SOAP-huvudet bearbetades korrekt; annars false.
Exempel
Följande MyWebService XML-webbtjänst definierar MyHeader SOAP-huvudet och kräver att det skickas med alla anrop till MyWebMethod XML-webbtjänstmetoden. Dessutom MyWebMethod tar emot alla SOAP-huvuden förutom MyHeader SOAP-huvudet. För SOAP-huvuden som MyWebMethod kan bearbetas DidUnderstand är inställt på 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
Kommentarer
För SOAP-huvuden som definierats av en XML-webbtjänst förutsätter ASP.NET att XML-webbtjänstmetoden bearbetade SOAP-huvudet korrekt genom att ange det ursprungliga värdet för DidUnderstand till true. För SOAP-huvuden som inte definierats av XML-webbtjänsten är falsedet ursprungliga värdet . Om ASP.NET identifierar SOAP-huvuden som skickas till en XML-webbtjänstmetod med DidUnderstand inställd på false efter att metoden har returnerats, returneras en SoapHeaderException till XML-webbtjänstklienten i stället för resultatet från XML-webbtjänstmetoden.
