SoapHeaderDirection Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, ob der Empfänger des SoapHeader der XML-Webdienst, der XML-Webdienstclient oder beides ist.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
[<System.Flags>]
type SoapHeaderDirection =
Public Enum SoapHeaderDirection
- Vererbung
- Attribute
Felder
Fault | 4 | Gibt an, SoapHeader an den XML-Webdienstclient gesendet wird, wenn eine Ausnahme von der XML-Webdienstmethode ausgelöst wird. |
In | 1 | Gibt an, SoapHeader an den XML-Webdienst gesendet wird. |
InOut | 3 | Gibt an, SoapHeader sowohl an den XML-Webdienst als auch an den XML-Webdienstclient gesendet wird. |
Out | 2 | Gibt an, SoapHeader an den XML-Webdienstclient gesendet wird. |
Beispiele
Die folgende XML-Webdienstmethode gibt an, dass die myHeader
SoapHeader vom XML-Webdienstclient an den XML-Webdienstdienst gesendet wird, und dann zurück an den XML-Webdienstclient, unabhängig von einer Ausnahme, die während der Ausführung der XML-Webdienstmethode ausgelöst wird.
public ref class MyHeader: public SoapHeader
{
public:
String^ MyValue;
};
public ref class MyWebService
{
public:
MyHeader^ myHeader;
[WebMethod]
[SoapHeader("myHeader",
Direction=SoapHeaderDirection::InOut|SoapHeaderDirection::Fault)]
void MySoapHeaderReceivingMethod()
{
// Set myHeader->MyValue to some value.
}
};
public class MyHeader : SoapHeader {
public string MyValue;
}
public class MyWebService {
public MyHeader myHeader;
[WebMethod]
[SoapHeader("myHeader",
Direction=SoapHeaderDirection.InOut | SoapHeaderDirection.Fault)]
public void MySoapHeaderReceivingMethod() {
// Set myHeader.MyValue to some value.
}
}
Public Class MyHeader
Inherits SoapHeader
Public MyValue As String
End Class
Public Class MyWebService
Public myHeader As MyHeader
<WebMethod, _
SoapHeader("myHeader", _
Direction := SoapHeaderDirection.InOut Or SoapHeaderDirection.Fault)> _
Public Sub MySoapHeaderReceivingMethod()
' Set myHeader.MyValue to some value.
End Sub
End Class
Hinweise
Ein SoapHeaderAttribute kann entweder auf eine XML-Webdienstmethode oder eine Methode einer Proxyklasse auf einen XML-Webdienst angewendet werden. In beiden Fällen werden die Empfänger durch die eigenschaft SoapHeaderAttribute.Direction angegeben. Um anzugeben, dass eine XML-Webdienstmethode einen SOAP-Header zurückgibt, wenn während der Ausführung eine Ausnahme ausgelöst wird, wenden Sie eine SoapHeaderAttribute auf die Methode an, und legen Sie die SoapHeaderAttribute.Direction-Eigenschaft auf Fault
fest.